Meta Ad Library API
Ads, advertisers.
The Meta Ad Library API lets you search ads by keyword, list an advertiser's ads, find advertisers and read one ad, 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-10-17.
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
4 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 searchPreviewSearch the ads running now in the Meta Ad Library (Facebook, Instagram and Meta's other apps) by keyword.meta.ad_search2 credits
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://api.socialtoai.com/v1/call/meta.ad_search \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "running shoes" }'POST /v1/call/meta.ad_searchYour key goes in the Authorization headerAdvertiser's adsPreviewGet the ads an advertiser (a Facebook page) is running now in the Meta Ad Library, by the page's ID.meta.advertiser_ads2 credits
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://api.socialtoai.com/v1/call/meta.advertiser_ads \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "id": "182162001806727" }'POST /v1/call/meta.advertiser_adsYour key goes in the Authorization headerAdvertiser searchPreviewFind advertisers (Facebook pages) in the Meta Ad Library by name.meta.advertiser_search2 credits
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://api.socialtoai.com/v1/call/meta.advertiser_search \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "puma" }'POST /v1/call/meta.advertiser_searchYour key goes in the Authorization headerAd detailPreviewGet one ad of the Meta Ad Library by its library ID or link.meta.ad_detail2 credits
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://api.socialtoai.com/v1/call/meta.ad_detail \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "id": "1466307095509411" }'POST /v1/call/meta.ad_detailYour key goes in the Authorization headerPreview: this interface is not marked stable yet, so its parameters and fields may still change. It is charged like any other call, and a failed call is not charged.
Does 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.