Facebook Ad Library company ads
scrapecreators/facebook-adlibrary-company-adsGet public social media posts, profiles and videos with Facebook Ad Library company ads from ScrapeCreators through one Spiral API key. Lists a company's ads from the Meta Ad Library, one page at a time: each ad's id, page, platforms, dates and creative text. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
Up to $0.0013 per run.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 30 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
trim | true or false | — |
|
cursor | text | — | The |
pageId | text | — | The company's Ad Library page id. Send this or |
status | one of ALL, ACTIVE, INACTIVE | — | Which ads: running ones ( |
country | text | — | One 2-letter country code ( |
sort_by | one of total_impressions, relevancy_monthly_grouped | — | Most impressions first (the default) or most recent first ( |
end_date | text | — | Latest date, |
language | text | — | A 2-letter language code ( |
media_type | one of ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE | — | The ads' media ( |
start_date | text | — | Earliest date, |
companyName | text | — | The company's name. Send this or |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "scrapecreators",
"model": "scrapecreators/facebook-adlibrary-company-ads",
"input": {
"pageId": "15087023444"
}
}'Frequently asked questions
How much does Facebook Ad Library company ads cost?
Up to $0.0013 per run. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Facebook Ad Library company ads through an API?
Send `POST /v1/runs` with `"provider": "scrapecreators"`, `"model": "scrapecreators/facebook-adlibrary-company-ads"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with ScrapeCreators to use Facebook Ad Library company ads?
No. Spiral runs it on its own ScrapeCreators account and charges your Spiral balance.
Can my AI agent use Facebook Ad Library company ads?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.