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.
soundcoreSponsored
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.
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.
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"pageId": "266556540473351",
"country": "US",
"limit": 500
}
}limit: 500Ads 1–50038.1scursor: "eyJ2IjoxLCJoIj…"Ads 501–85528.7s
855 ads across two responses, each returned oncetotalCount: 855
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.
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"action": "advertisers",
"query": "soundcore",
"country": "US"
}
}
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 followers265641373306592Filter 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.
{
"taskType": "ADS",
"payload": {
"platform": "meta_ad_library",
"pageId": "266556540473351",
"country": "US",
"mediaType": "video",
"publisherPlatforms": [
"instagram"
],
"startDate": "2026-11-01"
}
}activeStatusall903active856inactive47
mediaTypememe761video98image0
publisherPlatformsfacebook856instagram856threads340audience_network202whatsapp176messenger0
This request98
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.
Soundcore Liberty 5 Pro211 ads2 advertisers
soundcore210
Apple AirPods Pro 3464 ads90 advertisers
Cosmopolitan63
James Martin Jewelers55
BILL27
Technics EAH-AZ800 ads
Nothing Ear (3)1 ad1 advertiser
Sony WF-1000XM51 ad1 advertiser
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 →| Plan | 1,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.





