Use case, Meta Ad Library

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

Send a company domain, 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 - https://looot.ai/skill.md

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 domain 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 domain, a Facebook page or a keyword

nike.com

You get

  • Ad creative text, images and video
  • Active or ended status
  • Platforms the ad runs on
  • Start date
  • Advertiser page

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 steps across 3 providers.
  • Runs on demand, whenever you ask.
Prompt: Meta Ad Library API
Use looot to list the ads nike.com 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 - https://looot.ai/skill.md

Before you start

Settle these before the first run

  • 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 domain 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.

For agents
use case
Meta Ad Library API
run
company
schedule
on demand
step
Fetch the ads: scrapecreators adyntel searchapi-io
setup
https://looot.ai/skill.md
llms.txt
https://looot.ai/llms.txt
updated
2026-10-04
markdown /use-cases/meta-ads-library-api.md

Try Meta Ad Library with your own agent.

Start your workspace, top up, and paste the prompt into the agent you already use.

Start your workspace See agent recipes