Search Meta ads
search_meta_adsRead-only
Retrieve structured Meta (Facebook/Instagram) ad library data using a keyword, advertiser name, or page ID. Returns JSON with ad details: page name, body, CTA, link, dates, and media.
Instructions
Structured Meta (Facebook/Instagram) Ad Library pull — use when you know exactly WHAT to fetch: a keyword (query) OR one advertiser (companyName / pageId). Returns compact JSON {page_name, body, cta, link, dates, media} per ad. For open-ended research that needs judgment across platforms, use research_ads instead. Spends ScrapeCreators credits (~1–2).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | max ads returned (1–25, default 8) | |
| query | No | keyword search across ALL advertisers (use INSTEAD of companyName/pageId) | |
| pageId | No | one advertiser’s ads by Facebook page id (most precise) | |
| status | No | ACTIVE = currently running; default ALL (includes proven past winners) | |
| country | No | 2-letter code or 'ALL' (default ALL) | |
| mediaType | No | filter by creative type (default ALL) | |
| companyName | No | one advertiser’s ads by brand name |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ads | No | the compact ad objects ({page_name, body, cta, link, dates, media}) | |
| found | No | total ads found upstream |