Skip to content

Meta Ad Library API: Facebook and Instagram Ads as JSON

Search the Meta Ad Library by keyword or by advertiser and get the ads running on Facebook, Instagram, Messenger, WhatsApp and Threads as JSON through one async API, each with its text, images and video, landing page, call to action, start date and platforms.

Meta Ad Library searches run on November 20, 2026, drawn with the ads they returned.

Every ad an advertiser runs on Meta

Send taskType ADS with payload.platform meta_ad_library and an advertiser's Facebook page ID in pageId, or a keyword in query. Each ad comes back with its library ID, start date, the platforms it runs on, how many ads share its creative, its text, images or video, landing page and call to action, along with the library's count of matching ads. Results arrive by webhook or polling.

Active
Library ID: 2033461067351971
Started running on Nov 14, 2026
Platforms
This ad has multiple versions
5 ads use this creative and text
See summary details
soundcoreSponsored
🎧Anker soundcore AeroClip 2 — the world's clearest open-ear clip-on earbuds. Now $143.99 + free earrings.
libraryId2033461067351971
The ad's ID in the Meta Ad Library; libraryUrl opens it there.
startDateisActive2026-11-14 · true
The day the ad started running, and whether it runs now.
platformsFACEBOOK, INSTAGRAM
The Meta apps that show the ad.
versionsformat5 · DCO
How many ads share this creative and text; DCO marks an ad Meta assembles from cards.
pageNamepageLikeCountsoundcore · 147919
The advertiser's page and its likes, with pageId to search its other ads.
body🎧Anker soundcore AeroClip 2 — the world's clearest open-ear clip-on earbuds. Now $143.99 + free earrings.
The ad's text above the image.
cards2
Each card with its image or video, text and link; the library shows the first.
titlectaTextlinkUrlAeroClip 2 Open-Ear · Shop now
The link bar under the image: its title, description, button and linkUrl.
The first ad an ADS search of soundcore's page in the US returned on November 20, 2026, drawn as the library's card.
Step 1

Search by keyword or by advertiser

query matches the words in an ad's text in any order, or as an exact phrase with searchType keyword_exact_phrase. pageId lists one advertiser's ads. country sets where the ads ran, ALL searches every country, and limit returns up to 500 ads in one request. Send a response's nextCursor as cursor to receive the ads that follow.

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "pageId": "266556540473351",
    "country": "US",
    "limit": 500
  }
}
  1. limit: 500Ads 1–50038.1s
  2. cursor: "eyJ2IjoxLCJoIj…"Ads 501–85528.7s

855 ads across two responses, each returned oncetotalCount: 855

Two ADS searches of soundcore's page in the US on November 20, 2026; the second sent the first one's nextCursor as cursor.
Step 2

Find an advertiser's page ID by name

action advertisers returns the Facebook pages whose names match query, in the order the library's search box suggests them, each with its pageId, category, likes, verified badge and Instagram account. Send the pageId you pick to receive that advertiser's ads.

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "action": "advertisers",
    "query": "soundcore",
    "country": "US"
  }
}
USsoundcore
"soundcore"Search this exact phrase
Advertisers
soundcore@soundcoreaudio · 148K follow this · Electronics@soundcoreaudio · 154K followers266556540473351
AnkerSoundcoreuk@ankersoundcoreUK · 1.8K follow this · Information Technology Company328639343660125
Anker soundcore Polska@AnkersoundcorePL · 1.4K follow this · Electronics@anker_soundcore_polska · 2.9K followers613865685153030
soundcore Deutschland1.2K follow this · Music & Audio@soundcore_de · 17.8K followers265641373306592
The advertisers action for “soundcore” in the US on November 20, 2026: the first 4 of the 15 pages it returned, in the order the library's search box suggests them, each with its pageId.
Step 3

Filter by status, format, platform and date

activeStatus picks active, inactive or all ads, mediaType keeps image, video or meme ads, and publisherPlatforms keeps the ads on Facebook, Instagram, Audience Network, Messenger, WhatsApp or Threads. contentLanguages, startDate and endDate narrow the ads to their languages and the days they ran, and sortBy orders them by impressions or by most recent.

JSON
{
  "taskType": "ADS",
  "payload": {
    "platform": "meta_ad_library",
    "pageId": "266556540473351",
    "country": "US",
    "mediaType": "video",
    "publisherPlatforms": [
      "instagram"
    ],
    "startDate": "2026-11-01"
  }
}
activeStatus
  • all903
  • active856
  • inactive47
mediaType
  • meme761
  • video98
  • image0
publisherPlatforms
  • facebook856
  • instagram856
  • threads340
  • audience_network202
  • whatsapp176
  • messenger0

This request98

The library's count for each filter on soundcore's page in the US, run on November 20, 2026. mediaType and publisherPlatforms count active ads.

What AI recommends, and who advertises it

Send a shopping question to an answer engine, then search each product it recommends by name in the Meta Ad Library to see which brands advertise their AI picks and which other advertisers run ads on those names.

ChatGPT recommended · “What are the best wireless earbuds under $200?”Active Meta ads that name it, US
  1. Soundcore Liberty 5 Pro211 ads2 advertiserssoundcore210
  2. Apple AirPods Pro 3464 ads90 advertisersCosmopolitan63James Martin Jewelers55BILL27
  3. Technics EAH-AZ800 ads
  4. Nothing Ear (3)1 ad1 advertiser
  5. Sony WF-1000XM51 ad1 advertiser
ChatGPT recommended these on November 19, 2026. On November 20, 2026, ADS searched each product's exact name among the active ads in the US; the bars count the ads each search returned, and the brands among the advertisers are named.

0.5 credits per 30 ads

A search costs 0.5 credits for every 30 ads it returns, with 0.5 credits at least: the default request for 30 ads costs 0.5 credits, and a 500-ad search up to 8.5. An advertiser search costs 0.5 credits. Only completed requests are charged.

View pricing →
Request cost by plan
Plan1,000 requests
Basic≈ $1.25
Max≈ $0.50

Effective rates assume all included monthly credits are used.

Explore related capabilities

Start with 500 free credits

Run your first task in the Playground, or call the API with your key.