Meta Ad Library API by APISH

Get public Meta Ad Library data as clean, consistent JSON: meta ad details (EU/UK transparency, advertiser), meta video ad transcript, ads of one advertiser, search Meta ads, search advertisers. 5 endpoints, one response shape, numbers parsed, absolute URLs.

How to use

1. Pick an Endpoint. Each option shows what it returns and its price in credits.
2. Enter its Parameters as JSON, for example {"id":"1016451784037642"}. All parameters are listed below.
3. Run. Each call becomes one row in the dataset. Use Batch to run the same endpoint for many inputs and Pages per input to follow pagination.

Pricing

Pay per event: you pay per APISH credit the call used. The price of each endpoint is in the table below. Calls that fail on our side (server errors, timeouts, blocks) are free.

Endpoints

Endpoint	Returns	Required parameters	Credits
/facebook/v1/adLibrary/ad	Meta ad details (EU/UK transparency, advertiser)	id	1
/facebook/v1/adLibrary/ad/transcript	Meta video ad transcript	id	1
/facebook/v1/adLibrary/company/ads	Ads of one advertiser	—	1
/facebook/v1/adLibrary/search/ads	Search Meta ads	q	1
/facebook/v1/adLibrary/search/companies	Search advertisers	q	1

Output

Each dataset row has endpoint, params, status, credits_used and the endpoint's data. Add "raw": 1 to the parameters to also get the site's original record, or "fields": "a,b.c" to return only the fields you need.

Endpoint details

Meta ad details (EU/UK transparency, advertiser)

Endpoint /facebook/v1/adLibrary/ad · 1 credit per successful call.

Parameters:

• id (required): Library ID or ad URL.
• page_id: Improves advertiser details.
• country

Example parameters: {"id":"1016451784037642"}

Meta video ad transcript

Endpoint /facebook/v1/adLibrary/ad/transcript · 1 credit per successful call.

Parameters:

• id (required)

Example parameters: {"id":"915491414586324"}

Ads of one advertiser

Endpoint /facebook/v1/adLibrary/company/ads · 1 credit per successful call.

Parameters:

• page_id: Facebook page ID (or view_all_page_id URL).
• company: Advertiser name, when page_id is unknown.
• country
• status
• cursor: Value of next_cursor from the previous page.
• ad_type — one of all, political_and_issue_ads, housing_ads, employment_ads, credit_ads, financial_products_and_services_ads: all (default), political_and_issue_ads, housing_ads, employment_ads, credit_ads or financial_products_and_services_ads.
• media_type — one of all, image, video, meme, image_and_meme, none: all (default), image, video, meme, image_and_meme or none.
• platforms: Where the ads ran, comma-separated: facebook, instagram, audience_network, messenger, threads, whatsapp.
• languages: Ad languages, comma-separated ISO codes (en, es, fr…).
• start_date: Ads delivered on or after this day (YYYY-MM-DD; the Ad Library's "impressions by date" filter).
• end_date: Ads delivered on or before this day (YYYY-MM-DD).
• sort — one of impressions, impressions_asc, newest: Default relevance; impressions (high to low), impressions_asc (low to high) or newest.
• limit: Ads per page, 1-30 (default 30).

Search Meta ads

Endpoint /facebook/v1/adLibrary/search/ads · 1 credit per successful call.

Parameters:

• q (required)
• country
• status: active, inactive or all.
• match: keyword or exact.
• cursor: Value of next_cursor from the previous page.
• ad_type — one of all, political_and_issue_ads, housing_ads, employment_ads, credit_ads, financial_products_and_services_ads: all (default), political_and_issue_ads, housing_ads, employment_ads, credit_ads or financial_products_and_services_ads.
• media_type — one of all, image, video, meme, image_and_meme, none: all (default), image, video, meme, image_and_meme or none.
• platforms: Where the ads ran, comma-separated: facebook, instagram, audience_network, messenger, threads, whatsapp.
• languages: Ad languages, comma-separated ISO codes (en, es, fr…).
• start_date: Ads delivered on or after this day (YYYY-MM-DD; the Ad Library's "impressions by date" filter).
• end_date: Ads delivered on or before this day (YYYY-MM-DD).
• sort — one of impressions, impressions_asc, newest: Default relevance; impressions (high to low), impressions_asc (low to high) or newest.
• limit: Ads per page, 1-30 (default 30).

Example parameters: {"q":"nike"}

Search advertisers

Endpoint /facebook/v1/adLibrary/search/companies · 1 credit per successful call.

Meta's advertiser typeahead is login-only; this ranks the advertisers behind matching ads.

Parameters:

• q (required)
• country

Example parameters: {"q":"nike"}

Support

Questions, bugs or a missing field? Open an issue in this Actor's Issues tab and we will reply there.

Public data only: nothing behind a login. You are responsible for how you use the data you collect.