Research
meta_search_ad_library
Search the Meta Ad Library for reference ads — by keyword across every advertiser, or every ad one advertiser is running.
read meta_search_ad_library
Search the Meta Ad Library for reference ads — by keyword across every advertiser, or every ad one advertiser is running. Returns advertiser, copy, CTA, landing page, media type and how long each ad has been live. Each result carries the sourceUrl a swipe is saved from. Costs an API credit per page.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Keyword search. |
company | string | No | An advertiser's Page name; wins over query. |
country | string | No | ISO 3166-1 alpha-2. Omit for all. |
mediaType | all | image | video | No | |
cursor | string | No | From a previous page. |