Install
How do I install this skill?
Two steps. Set up looot once, then save this skill file where your agent reads skills.
1. Set up looot once
set up looot - https://looot.ai/skill.mdWorks in Claude Code, Cursor, Codex and ChatGPT through MCP. Searching and inspecting are free.
2. Save the skill
mkdir -p ~/.claude/agent-skills/looot-meta-ads-library && curl -fsSL https://looot.ai/agent-skills/meta-ads-library/SKILL.md -o ~/.claude/agent-skills/looot-meta-ads-library/SKILL.mdOr open the raw SKILL.md and drop it into the skills folder of your own agent.
When it starts
What do I say to start this skill?
Any of these starts it. The agent asks for what is missing, nothing more.
- Example promptwhat ads is nike.com running on Facebook
- Example promptshow me the active Instagram ads of this brand
- Example promptfind ads that mention this keyword
It asks for
- A company domain, a Facebook page or a keyword
- The country
It hands back
- Ad creative text, images and video
- Active or ended status
- Platforms the ad runs on
- Start date
- Advertiser page
List each ad with its copy, format, platform and start date. Say whether each is active or ended.
How it runs
What does the agent do when it runs?
Four moves, in this order, with the price known before any money moves.
Step 1
Discover
looot discover finds the endpoints that match the task. It is free.
Step 2
Inspect
looot inspect shows the price and the exact input before anything is spent. It is free.
Step 3
Run
looot run executes the call with an idempotency key, so a retry never charges twice. The agent reads the run status, not the HTTP code.
Step 4
Fall back
On a provider error or a timeout the agent tries the next endpoint in the skill, cheapest first. It never retries a bad input elsewhere.
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 runs of this skill 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.
The file
What is inside the SKILL.md?
The whole file, as your agent reads it. No price is written in it: the agent reads the live price with looot inspect.
---
name: looot-meta-ads-library
description: Read a company's Meta ads. Use when the user says things like "what ads is nike.com running on Facebook", "show me the active Instagram ads of this brand" or "find ads that mention this keyword". Runs through looot, billed per call.
---
# Read a company's Meta ads
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.
This skill needs the looot skill set up first: https://looot.ai/skill.md
## Ask for these inputs
The job takes a company name, a Facebook page or a keyword. Example: Nike.
- A company domain, a Facebook page or a keyword
- The country
## Run it
1. Find the endpoint: `looot discover --mode auto --query "meta ad library"`. The endpoints listed below are the known matches.
2. Read the price and the input schema before spending: `looot inspect <endpoint-id>`. Tell the user the price, then run.
3. Run it: `looot run scrapecreators-facebook-adlibrary-company-ads-get --input '{"companyName":"Nike","country":"US"}' --idempotency-key <new-key> --wait`. Reuse the same key only to retry the same request.
4. Read the run's `status` and `error`, not the HTTP status. A run can return `failed` with a normal response.
5. If a run fails with a provider error or times out, try the next endpoint from the list below, cheapest first. If it fails on your input (a 4xx style error), fix the input. Do not retry it on other providers.
## Endpoints
Each endpoint reads the same job from a different provider. They differ in inputs, fields and price. Run `looot inspect` on the ones that take the input you hold, start with the cheapest, and move to the next on a provider error.
- `scrapecreators-facebook-adlibrary-company-ads-get`: 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-search-ads-get`: searches the library by keyword and returns matching ads from any advertiser, because the keyword matches ad text and not a brand
- `searchapi-io-meta-ad-library`: searches across Facebook, Instagram, Audience Network, Messenger and Threads, with filters for country, ad type, active status, media type and platform
## What comes back
- Ad creative text, images and video
- Active or ended status
- Platforms the ad runs on
- Start date
- Advertiser page
## Answer rule
List each ad with its copy, format, platform and start date. Say whether each is active or ended.
## Before you start
- 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.
## Cost rules
- Searching and inspecting are free. Running is billed per call at the price `looot inspect` shows.
- Say the price before the first run, and the total after a batch.
- Never loop a failing call. Stop after two failures and report what failed.
## When not to use this skill
Use `looot-google-serp` instead when you want what the company shows in Google search, not its Meta ads.
Page for people: https://looot.ai/agent-skills/meta-ads-library
Wrong fit
When should I use a different skill?
Use Read a Google results page when you want what the company shows in Google search, not its Meta ads.
FAQ
What do people ask about this skill?
The same job as a page with the full price ladder: Meta Ad Library API for AI agents. Updated 2026-10-04.
Platforms and providers behind this skill
- skill
- looot-meta-ads-library
- file
- https://looot.ai/agent-skills/meta-ads-library/SKILL.md
- difficulty
- easy
- input
- a company name, a Facebook page or a keyword
- endpoint
- scrapecreators-facebook-adlibrary-company-ads-get
- endpoint
- scrapecreators-facebook-adlibrary-search-ads-get
- endpoint
- searchapi-io-meta-ad-library
- setup
- https://looot.ai/skill.md
- llms.txt
- https://looot.ai/llms.txt
- updated
- 2026-10-04
Try this skill with your own agent.
Start your workspace, top up, and save the skill where your agent reads it.