# Read a company's Meta ads: agent skill

Meta Ad Library API for an agent: it sends a company domain, 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.

## When it starts

- what ads is nike.com running on Facebook
- show me the active Instagram ads of this brand
- find ads that mention this keyword

## What it asks for

- A company domain, a Facebook page or a keyword
- The country

## How it runs

- looot discover finds the endpoint
- looot inspect shows the price and the input schema
- looot run executes it, billed per call
- Endpoints in order: scrapecreators-facebook-adlibrary-company-ads-get, adyntel-facebook, scrapecreators-facebook-adlibrary-search-ads-get, searchapi-io-meta-ad-library, adyntel-facebook-ad-search

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

## Install

Save the skill file as /agent-skills/meta-ads-library/SKILL.md, or tell your agent: set up looot, then use /agent-skills/meta-ads-library/SKILL.md.

## Difficulty

easy

## How do I see the ads a competitor is running?

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.

## Can I search ads by keyword?

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.

## Does it cover Instagram?

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

## Can I see how long an ad has been running?

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.

## Is the Ad Library public?

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.

## How much does one company cost?

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.