> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/use-cases/ad-intelligence-api>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/use-cases/ad-intelligence-api.mdx>

---

# Ad intelligence API

**What API returns competitors' ads from the public ad libraries?** Social Fetch does. Find the advertiser with the Meta, Google or LinkedIn ad library search, then list its ads: copy, creatives, start dates and the platforms each ad runs on. Meta, Google, LinkedIn and TikTok ad libraries share one API key and one response shape, and you pay per lookup.

See what competitors are running across the Meta, Google, LinkedIn and TikTok ad libraries: creatives, copy, start dates and platforms, in one JSON shape you can store and compare.

## A real run, measured and priced

Find a competitor's ad accounts and pull what is running, run on 21 Nov 2026 against live public data. A competitor's live Meta ads and its LinkedIn ad history, from three calls.

| Request | Result | Credits | Time |
| --- | --- | --- | --- |
| `GET /v1/facebook/ad-library/companies/search?query=Notion` | 15 matching pages, with Notion's own page first. | 3 | 1.5 s |
| `GET /v1/facebook/ad-library/companies/ads?pageId=825120160874613` | 30 active ads, started 21 May to 28 Aug, on Facebook and Instagram. | 3 | 4.1 s |
| `GET /v1/linkedin/ad-library/ads/search?company=Notion` | 24 ads on the first page, from 5,594 in all. | 3 | 9.2 s |

Total: 9 credits, 14.8 s of server time. Starter pack ($14 per 1,000 credits): $0.13. Scale pack ($1.64 per 1,000 credits): $0.015.

Every ad library is its own website. Meta, Google, LinkedIn and TikTok each search differently, page differently and show different fields, so a weekly competitor review means four tabs and a lot of screenshots.

Suites lock you into contracts. Ad intelligence suites solve it with an annual contract and a fixed list of tracked brands. Adding a competitor mid-quarter can mean a call with sales.

You need each library's ads as data: who is advertising, what the copy says, when each ad started and where it runs, so your team can diff this week against last.

## Endpoints

| Method | Path | What it does |
| --- | --- | --- |
| GET | `/v1/facebook/ad-library/companies/search` | Find an advertiser's Meta page id from its name, the key for listing its ads. |
| GET | `/v1/facebook/ad-library/companies/ads` | Every ad a page is running on Facebook and Instagram, with copy, creatives, start dates and platforms. |
| GET | `/v1/facebook/ad-library/ads/search` | Search all Meta ads by keyword, for ads about a topic or product rather than one advertiser. |
| GET | `/v1/google/ad-library/advertisers/search` | Find an advertiser in Google's ads transparency library. |
| GET | `/v1/google/ad-library/companies/ads` | An advertiser's Google ads, by advertiser id or by website domain. |
| GET | `/v1/linkedin/ad-library/ads/search` | LinkedIn ads by company or keyword, for B2B messaging and offers. |
| GET | `/v1/tiktok/ad-library/ads/search` | TikTok ads by keyword, for consumer brands' short-form creative. |
| GET | `/v1/facebook/ad-library/ads` | One Meta ad in full, when a list result needs its complete details. |

## Workflow

1. **Resolve each competitor once.** Search each library for the competitor and store the ids it returns: Meta page id, Google advertiser id, LinkedIn company name.
2. **Pull the ads on a schedule.** List each competitor's ads weekly, or daily around a launch. Store every ad by its library id with the date you saw it.
3. **Diff against last time.** New ids are new ads. Ads that disappear have stopped. Long-running ads are the ones that work, so flag anything active for more than a month.
4. **Read the creative.** Group ads by message, offer and format. Pass the copy to an LLM to tag the angle: price, feature, social proof, urgency.
5. **Report it.** Send a weekly digest to the team, or feed the data to your own dashboard. Credits never expire, so quiet weeks cost nothing.

## Example: list the ads a Meta page is running

```bash
curl -sS \
  -H "x-api-key: YOUR_API_KEY" \
  -G "https://api.socialfetch.dev/v1/facebook/ad-library/companies/ads" \
  --data-urlencode "pageId=825120160874613"
```

## Why growth teams track ads here

- Four ad libraries, one shape. Meta, Google, LinkedIn and TikTok ads come back in the same JSON layout, so one job watches them all.
- Any competitor, any time. There is no tracked-brand list to fill; look up a new competitor the day you hear about it.
- Pay per lookup. No annual contract and no seats: pulling ten competitors' Meta ads once a week is 120 credits over four weeks.
- You only pay for completed lookups. Requests that fail on our side cost nothing.
- Public data only. Every ad comes from the platforms' own public ad libraries.

## FAQ

### What API returns competitors' ads from the public ad libraries?

Social Fetch. It reads the Meta, Google, LinkedIn and TikTok ad libraries and returns each ad's copy, creatives, start date and platforms in one JSON shape, with one API key.

### Can I see how much a competitor spends on ads?

Only where a library publishes it. For most commercial ads the libraries show the creative, the copy, the start date and where it runs, not the budget.

### Is there a free way to try it?

Yes. The free [Facebook Ad Library tool](https://www.socialfetch.dev/tools/facebook-ad-library) and [LinkedIn Ad Library tool](https://www.socialfetch.dev/tools/linkedin-ad-library) search the same data in your browser, and new accounts get free credits for the API.

### How often should I pull competitor ads?

Weekly is enough for most teams. Around a competitor's launch or a sales season, daily pulls catch new creative while it is still being tested.
