Agent skill, easy

Read a company's Meta ads, as a skill your agent installs.

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.

Give this to your agent
set up looot - https://looot.ai/skill.md

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

Give this line to your agent
set up looot - https://looot.ai/skill.md

Works in Claude Code, Cursor, Codex and ChatGPT through MCP. Searching and inspecting are free.

2. Save the skill

Save the skill file for Claude Code
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.md

Or 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 prompt
    what ads is nike.com running on Facebook

  • Example prompt
    show me the active Instagram ads of this brand

  • Example prompt
    find 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.

  1. Step 1

    Discover

    looot discover finds the endpoints that match the task. It is free.

  2. Step 2

    Inspect

    looot inspect shows the price and the exact input before anything is spent. It is free.

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

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

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

SKILL.md for Read a company's Meta ads
---
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?

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.

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

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