Meta Ad Library API for your agent. One call per company.
The short answer
The short answer
Meta Ad Library API for an agent: it sends a company name, a Facebook page or a keyword to a catalog endpoint and reads ad creative text, images and video back. Several providers sell the call, so the agent tries the cheapest first. You pay per call, and a failed call costs nothing.
Updated
- Ad creative text, images and video
- Active or ended status
- Platforms the ad runs on
- Start date
- Advertiser page
The job
What the Meta Ad Library API gives your agent
Meta publishes every ad that runs on Facebook and Instagram in its Ad Library. Your agent reads that library for you. Send a company name or a page and see the ads it has live, with the copy, the format and when each one started. That is the fastest way to see how a competitor sells.
The providers split two ways. Some start from a company and list its ads. Others start from a keyword and return the ads that match, which finds firms you had not named. One covers Facebook, Instagram, Audience Network, Messenger and Threads together, and filters by platform, media type and active status.
You give
a company name, a Facebook page or a keyword
Nike
You get
- Ad creative text, images and video
- Active or ended status
- Platforms the ad runs on
- Start date
- Advertiser page
Providers, cheapest first
What actually differs between providers
Today the price runs from $0.00188 to $0.0040 across 3 endpoints. The dearest costs about 2.1 times the cheapest. Price is only one difference. Each entry below says what that endpoint takes or returns that the others do not.
ScrapeCreators
$0.00188 / callLists all ads currently running for a company by name or page ID, with filters for country, media type, date range and language.
scrapecreators-facebook-adlibrary-company-ads-getScrapeCreators
$0.00188 / callSearches the library by keyword and returns matching ads from any advertiser, because the keyword matches ad text and not a brand.
scrapecreators-facebook-adlibrary-search-ads-getSearchAPI.io
$0.0040 / callSearches across Facebook, Instagram, Audience Network, Messenger and Threads, with filters for country, ad type, active status, media type and platform.
searchapi-io-meta-ad-library
Cost
What 100 Meta Ad Library runs cost
$0.1880
100 companies cost about $0.1880 through the cheapest endpoint, at ScrapeCreators, and about $0.4000 through the dearest. Each run is one call.
Sample calls
The request and what comes back
Each run is one POST to /v1/runs with an endpoint id and an input. These are illustrative calls with generic values. The run's result holds the provider's own fields.
{"endpointId":"scrapecreators-facebook-adlibrary-company-ads-get","input":{"companyName":"Nike","country":"US"},"wait":30}// POST /v1/runs, then read run.status and run.result // result: lists all ads currently running for a company by name or page ID, with filters for country, media type, date range and language
The prompt
Copy one prompt, give it to your agent.
Edit the names and numbers, paste it, and the agent runs the job and shows the cost.
- One run is one company.
- 1 step across 2 providers.
- Runs on demand, whenever you ask.
set up looot for Meta Ad Library API - https://looot.ai/use-cases/meta-ads-library-api/skill.mdBefore you start
Settle these before the first run
- For one brand, find its page first. Call scrapecreators-facebook-adlibrary-search-companies with the name to get the page_id, then scrapecreators-facebook-adlibrary-company-ads-get with pageId. A keyword search matches ad text, so a brand name returns broad, unrelated ads.
- Filter by country. The library is searchable per country, and a global pull returns a pile you cannot read.
- Ask for active ads when you want what runs now. Ended ads stay in the library, and they tell a different story about what the company tried.
- Use the ad id to go deeper. One provider returns an ad's details and its video transcript, and both start from the id a search returns.
FAQ
Questions people ask
More ways to run this job
- use case
- Meta Ad Library API
- run
- company
- schedule
- on demand
- step
- Fetch the ads: scrapecreators searchapi-io
- setup
- https://looot.ai/use-cases/meta-ads-library-api/skill.md
- llms.txt
- https://looot.ai/llms.txt
- updated
- 2026-10-04
Try Meta Ad Library with your own agent.
Start your workspace, top up, and paste the prompt into the agent you already use.