Scrapecreators Facebook Ads
scrapecreators_facebook_adsSearch the Facebook / Meta Ad Library by keyword or advertiser and return active ad creatives: advertiser page, ad body text, media, platforms, run dates, and active status. Example: scrapecreators_facebook_ads({ query: "running shoes", country: "US", _apiKey: "your-key" })
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "running shoes",
"_apiKey": "your-scrapecreators-api-key",
"country": "US"
},
"name": "scrapecreators_facebook_ads"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Keyword or advertiser/page name to search for, e.g. "running shoes" or "Nike" | |
| cursor | No | Pagination cursor returned in a previous response (optional) | |
| status | No | Ad status filter: "ACTIVE", "INACTIVE", or "ALL" (default ACTIVE) | |
| _apiKey | Yes | ScrapeCreators API key (sign up at https://app.scrapecreators.com) | |
| ad_type | No | Ad type filter, e.g. "ALL", "POLITICAL_AND_ISSUE_ADS" (optional) | |
| country | No | 2-letter country code to scope the search, e.g. "US" (default ALL) | |
| media_type | No | Media type filter, e.g. "IMAGE", "VIDEO", "ALL" (default ALL) | |
| search_type | No | Match mode, e.g. "keyword_unordered" or "keyword_exact_phrase" (optional) |