Facebook An advertiser's ads API
Every ad an advertiser is running or ran. This supported crawlfeed endpoint returns Ad[] in the shared data and meta response envelope.
Request
Send an authorized GET request to this route. The values in the examples are starting points; replace them with the public Facebook item or query you want to read.
Parameters
| Name | Use | What it controls |
|---|---|---|
| advertiser | Required | Advertiser name, page id or domain. |
| country | Optional | ISO country code. |
| cursor | Optional | Continue from a previous page. |
| fresh | Optional | Skip the cache. Costs double. |
You can also pass include_raw=true to include the source payload. Read response format details.
Copy a working request
Set CRAWLFEED_KEY to your API key. The an advertiser's ads operation costs 1 credit at the standard rate; fresh=true skips cache and doubles the cost.
curl -G https://api.crawlfeed.dev/v1/facebook/ads \
-H "Authorization: Bearer $CRAWLFEED_KEY" \
--data-urlencode "advertiser=nike.com"Read more than one page
This operation can return a page of results with meta.next_cursor. If that field is present, send it as cursor in a follow-up request. Each page is a separate billable call. See the pagination guide for the full loop.
What happens next?
Use the normalized Ad[] value from data in your application, and inspect meta for credits, source and pagination. The type reference lists fields. Public data availability can vary by item and platform.