Use case, Meta Ad Library

Meta Ad Library API for your agent. One call per company.

Send a company name, a Facebook page or a keyword. Read ad creative text and images back. Your agent picks the provider, and you pay per call.

Give this to your agent
set up looot for Meta Ad Library API - https://looot.ai/use-cases/meta-ads-library-api/skill.md

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.

  1. ScrapeCreators logoScrapeCreators

    Lists 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-get
    $0.00188 / call
  2. ScrapeCreators logoScrapeCreators

    Searches 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-get
    $0.00188 / call
  3. SearchAPI.io logoSearchAPI.io

    Searches 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
    $0.0040 / call

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.

Request
{"endpointId":"scrapecreators-facebook-adlibrary-company-ads-get","input":{"companyName":"Nike","country":"US"},"wait":30}
ResponseSample output
// 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.
Prompt: Meta Ad Library API
Use looot to list the ads Nike runs on Facebook and Instagram in the United States right now, with the creative text, the format and the start date. 1. Set up https://looot.ai/skill.md. 2. Search the catalog for each step and check its price before you call. 3. Run the cheapest endpoint that fits. 4. Show the results as a table and the total cost.

Give this to your agent
Setup command
set up looot for Meta Ad Library API - https://looot.ai/use-cases/meta-ads-library-api/skill.md

Before 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

Send the competitor's name or Facebook page to an ad-library endpoint. Your agent returns the ads that are live, with the copy, the format and the start date.

Yes. Two of the providers here take a keyword and return the matching ads across advertisers. That is how you find who else sells in your space.

Yes. Meta's Ad Library covers Facebook and Instagram, and one provider here also covers Audience Network, Messenger and Threads.

Each ad carries a start date, and ended ads show an end date. An ad that has run for months is usually one that works.

Yes. It is Meta's own public record of ads. looot returns what the providers read from it, and it does not show targeting or spend for ordinary commercial ads.

You pay per call, and the price depends on the provider your agent picks. This page reads the cheapest live price from the catalog and shows no number when the catalog is unreachable.

No. A call that fails at the provider costs nothing, and your agent can retry it or send it to another provider.

No. One looot key reaches every provider in the catalog. You top up once, and each call is billed at the price shown before it runs.

Send a POST to /v1/runs with the endpoint id, the input and a new idempotency key, and your looot token in the Authorization header. With wait set to 30, the answer comes back in the response when the run ends within 30 seconds. Otherwise poll GET /v1/runs/<runId>.

That needs scheduled runs, not available yet. Run it by hand whenever you want fresh results.

No. looot bills per call, and nothing runs while your agent is idle.

More ways to run this job

For agents
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.