Spiral gives your agent every tool with one account. Browse the tools →

ScrapeCreatorsSocial MediaAvailable now

Facebook Ad Library company ads

scrapecreators/facebook-adlibrary-company-ads

Get 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.

Run time p50 · last 24 hours
4.1s
Success rate · last 24 hours
97.8%

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

FieldKindDefaultDescription
trimtrue or false—

true answers a shorter version of each ad.

cursortext—

The cursor of the previous page, for the next page.

pageIdtext—

The company's Ad Library page id. Send this or companyName.

statusone of
ALL, ACTIVE, INACTIVE
—

Which ads: running ones (ACTIVE, the default), stopped ones or all.

countrytext—

One 2-letter country code (US); all countries when left out.

sort_byone of
total_impressions, relevancy_monthly_grouped
—

Most impressions first (the default) or most recent first (relevancy_monthly_grouped).

end_datetext—

Latest date, YYYY-MM-DD.

languagetext—

A 2-letter language code (EN) to filter the ads on.

media_typeone of
ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE
—

The ads' media (ALL by default; MEME is an image with text).

start_datetext—

Earliest date, YYYY-MM-DD.

companyNametext—

The company's name. Send this or pageId.

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.