list_creative_library

Browse the organization’s Creative Studio Library — the actual creatives (synced from connected ad accounts, plus generated/uploaded drafts) with ad copy, a viewable media URL per creative, and fixed 30-day rollups.

Use this to SEE what the org’s ads look like (fetch each media_url) — for example, to compare messaging and angles against competitor ads from the insights server’s list_competitor_ads. list_ads / get_ad_performance return names and metrics only; this returns the creative content itself.

Parameters#

Returns#

{
  "creatives": [
    {
      "id": "ad_crtv_abc123",
      "name": "Summer hero v2",
      "platform": "meta_ads",
      "format": "image",
      "lifecycle": "active",
      "source": "synced",
      "media_url": "https://…/thumb.jpg",
      "copy": { "headline": "…", "body": "…", "cta": "SHOP_NOW" },
      "linked_ads": [
        { "ad_id": "120210", "ad_group_id": "120200", "campaign_id": "120100", "status": "active" }
      ],
      "spend_30d": 1240.55,
      "impressions_30d": 84000,
      "clicks_30d": 910,
      "ctr_30d": 0.0108,
      "roas_30d": 3.1,
      "conversions_30d": 41,
      "frequency_30d": 2.4,
      "first_seen_at": "2026-05-02T00:00:00+00:00",
      "last_active_at": "2026-07-11T00:00:00+00:00"
    }
  ],
  "total": 132,
  "limit": 24,
  "sort_by": "last_active",
  "source": "adlyse.creative_library@v1"
}

media_url prefers the durable mirrored thumbnail over the platform’s expiring CDN link. linked_ads lists the platform ads that run or ran the creative, live ones first: status is active, inactive, or null until the next sync has seen the ad, and ad_group_id (ad set on Meta) is null where the platform has no such tier. Pass them to pause_creative_ads. Rollups are fixed 30-day figures computed at the last sync (ctr_30d is a fraction); for custom windows use get_ad_performance.

Errors#