Meta Ad Library API
Ads, advertisers.
The Meta Ad Library API lets you search ads by keyword, list an advertiser's ads, find advertisers, read one ad and get the transcript of an ad's video, with no Meta Ad Library account or login. Each call costs 2 credits ($0.004 to $0.0067); failed calls are free. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-11-15.
Last tested: Last updated:
/v1/call/meta.ad_search200 OK2 creditsquery: "running shoes"- entry_type
- ad
- format
- image
- text
- …
- landing_url
- https://example.com/…
- first_shown_at
- 2026-10-07T07:00:00.000Z
- last_shown_at
- 2026-10-12T07:00:00.000Z
5 interfaces.
One response format.
Open a row to see its request. Its full parameters and response fields are on its own page.
Meta Ad Library has none of the 6 shared actions (search, trending, detail, comments, user_profile and user_posts). Every interface here is called by its own op, through POST /v1/call/{op}.
Ad Library searchSearch the ads running now in the Meta Ad Library (Facebook, Instagram and Meta's other apps) by keyword.meta.ad_search2 credits≈ $0.0067$0.23 per 1,000 (up to 30 a page)
Search the ads running now in the Meta Ad Library (Facebook, Instagram and Meta's other apps) by keyword: advertiser, text, headline, images and videos, landing page, first and last day shown; can be limited to a country and to image or video ads, sorted by impressions or newest first. 30 ads a page.
query+3 optionalcurl https://socialtoai.app/v1/call/meta.ad_search \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "query": "running shoes" }'POST /v1/call/meta.ad_searchYour key goes in the Authorization headerAdvertiser's adsGet the ads an advertiser (a Facebook page) is running now in the Meta Ad Library, by the page's ID.meta.advertiser_ads2 credits≈ $0.0067$0.23 per 1,000 (up to 30 a page)
Get the ads an advertiser (a Facebook page) is running now in the Meta Ad Library, by the page's ID: text, headline, images and videos, landing page, first and last day shown; can be limited to a country and to image or video ads, sorted by impressions or newest first. 30 ads a page.
id+3 optionalcurl https://socialtoai.app/v1/call/meta.advertiser_ads \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "182162001806727" }'POST /v1/call/meta.advertiser_adsYour key goes in the Authorization headerAdvertiser searchFind advertisers (Facebook pages) in the Meta Ad Library by name.meta.advertiser_search2 credits≈ $0.0067$0.45 per 1,000 (up to 15 a page)
Find advertisers (Facebook pages) in the Meta Ad Library by name: ID, name, picture, category, page likes, the linked Instagram account. The ID is what the advertiser's ads are asked for by.
querycurl https://socialtoai.app/v1/call/meta.advertiser_search \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "query": "puma" }'POST /v1/call/meta.advertiser_searchYour key goes in the Authorization headerAd detailGet one ad of the Meta Ad Library by its library ID or link.meta.ad_detail2 credits≈ $0.0067
Get one ad of the Meta Ad Library by its library ID or link: advertiser, text, headline, images and videos, landing page, first and last day shown, the platforms it is delivered on, and whether it is still running.
id or urlcurl https://socialtoai.app/v1/call/meta.ad_detail \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "1466307095509411" }'POST /v1/call/meta.ad_detailYour key goes in the Authorization headerAd video transcriptGet what is said in the video of a Meta Ad Library ad by its library ID or link, as one text.meta.ad_transcript2 credits≈ $0.0067
Get what is said in the video of a Meta Ad Library ad by its library ID or link, as one text.
id or urlcurl https://socialtoai.app/v1/call/meta.ad_transcript \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "974466855339122" }'POST /v1/call/meta.ad_transcriptYour key goes in the Authorization headerDoes Meta Ad Library have an official API?
Meta offers the official Ad Library API for searching ads about social issues, elections or politics delivered anywhere, and any ads delivered in the UK and EU. Access requires a Facebook account, confirming your identity and location, and a Meta developer account with an app.
Source: Meta Ad Library's developer documentation, checked 2026-10-17.
Meta Ad Library official API: access, prices and limits