# Ad library tools

> Ads running in the platforms' public ad libraries, by keyword, brand or advertiser.

The ads in the public ad libraries of Meta, TikTok, LinkedIn and Google, by keyword, brand or advertiser. Each call costs what the data provider charges for it, usually 1 credit.

For a teardown of one competitor, use [`ads_get_advertiser_ads`](https://www.manifoldmcp.com/docs/tools/ads#ads_get_advertiser_ads) (on Google, find the advertiser with [`ads_search_advertisers`](https://www.manifoldmcp.com/docs/tools/ads#ads_search_advertisers) first), then [`ads_get_ad`](https://www.manifoldmcp.com/docs/tools/ads#ads_get_ad) for the offer and the destination.

| Tool | What it does | Cost |
| --- | --- | --- |
| [`ads_search_ads`](#ads_search_ads) | Search ads | From 1 credit |
| [`ads_search_advertisers`](#ads_search_advertisers) | Find advertisers | From 1 credit |
| [`ads_get_advertiser_ads`](#ads_get_advertiser_ads) | Get an advertiser's ads | From 1 credit |
| [`ads_get_ad`](#ads_get_ad) | Get an ad | From 1 credit |

## `ads_search_ads`: Search ads

Ads running on a platform's public library, by keyword or brand.

**Use when:** "what ads is this category running", finding the angles and offers competitors are paying for.

**Not for:** one advertiser's whole set, use [`ads_get_advertiser_ads`](https://www.manifoldmcp.com/docs/tools/ads#ads_get_advertiser_ads). Google, whose library is keyed by advertiser: use [`ads_search_advertisers`](https://www.manifoldmcp.com/docs/tools/ads#ads_search_advertisers) first. Organic posts, use the platform's own search tool.

**Returns:** List, one page per call. `rows[]`: platform, id, url, advertiser, `advertiser_id`, headline, body, format, `first_shown`, `last_shown`, active, impressions, spend, countries, placements (where it ran: facebook, instagram), cta, `destination_url`, `media_url`. Impressions and spend are the ranges the library publishes, so they are text. meta.cursor pages the next set.

**Cost:** 1 credit per page. Cached 24 hours.

| Parameter | Default and notes |
| --- | --- |
| `platform` | Required, "facebook" \| "tiktok" \| "linkedin" |
| `query` | Required |
| `country` | Optional, an ISO code |
| `active_only` | False |

Also takes `cursor`, `provider`, `max_credits`, `dry_run`: see [common parameters](https://www.manifoldmcp.com/docs/tools#common-parameters).

```json
{
  "platform": "facebook",
  "query": "creatine gummies",
  "active_only": true
}
```

## `ads_search_advertisers`: Find advertisers

The advertisers matching a brand name in Google's ad library, with their ids.

**Use when:** before [`ads_get_advertiser_ads`](https://www.manifoldmcp.com/docs/tools/ads#ads_get_advertiser_ads) on Google, because that library is keyed by advertiser id and one brand has one entry per region.

**Not for:** the ads themselves, use [`ads_get_advertiser_ads`](https://www.manifoldmcp.com/docs/tools/ads#ads_get_advertiser_ads) with the id this returns. The other libraries, which search their ads directly with [`ads_search_ads`](https://www.manifoldmcp.com/docs/tools/ads#ads_search_ads).

**Returns:** List. `rows[]`: platform, id, name, region, `ads_estimate`, website.

**Cost:** 1 credit. Cached 7 days.

| Parameter | Default and notes |
| --- | --- |
| `platform` | Required, "google" |
| `query` | Required, a brand name |
| `region` | Optional, an ISO country code |

Also takes `provider`, `max_credits`, `dry_run`: see [common parameters](https://www.manifoldmcp.com/docs/tools#common-parameters).

```json
{
  "platform": "google",
  "query": "lululemon",
  "region": "US"
}
```

## `ads_get_advertiser_ads`: Get an advertiser's ads

Every ad one advertiser is running, from a platform's public library.

**Use when:** a competitor teardown: what they are running, since when, and with what offer.

**Not for:** a keyword sweep across advertisers, use [`ads_search_ads`](https://www.manifoldmcp.com/docs/tools/ads#ads_search_ads). One creative in full, use [`ads_get_ad`](https://www.manifoldmcp.com/docs/tools/ads#ads_get_ad).

**Returns:** List, one page per call. `rows[]`: platform, id, url, advertiser, `advertiser_id`, headline, body, format, `first_shown`, `last_shown`, active, impressions, spend, countries, placements (where it ran: facebook, instagram), cta, `destination_url`, `media_url`. Impressions and spend are the ranges the library publishes, so they are text. meta.cursor pages the next set.

**Cost:** 1 credit per page, or 25 on google with details. Cached 24 hours.

| Parameter | Default and notes |
| --- | --- |
| `platform` | Required, "facebook" \| "tiktok" \| "linkedin" \| "google" |
| `advertiser` | Required: a page id or name on facebook, an advertiser name on tiktok, a company name or id on linkedin, a domain or advertiser id on google |
| `country` | Optional |
| `active_only` | False |
| `details` | False; google only, adds the creative text and costs 25 credits |

Also takes `cursor`, `provider`, `max_credits`, `dry_run`: see [common parameters](https://www.manifoldmcp.com/docs/tools#common-parameters).

```json
{
  "platform": "google",
  "advertiser": "lululemon.com"
}
```

## `ads_get_ad`: Get an ad

One ad from a platform's public library, with its creative text and where it sends people.

**Use when:** reading the offer and the call to action behind an ad you found in a list.

**Not for:** a set of ads, use [`ads_search_ads`](https://www.manifoldmcp.com/docs/tools/ads#ads_search_ads) or [`ads_get_advertiser_ads`](https://www.manifoldmcp.com/docs/tools/ads#ads_get_advertiser_ads). What is said in an ad video, use the platform's transcript tool.

**Returns:** Record. `rows[]`: platform, id, url, advertiser, `advertiser_id`, headline, body, format, `first_shown`, `last_shown`, active, impressions, spend, countries, placements (where it ran: facebook, instagram), cta, `destination_url`, `media_url`. Impressions and spend are the ranges the library publishes, so they are text.

**Cost:** 1 credit. Cached 7 days.

| Parameter | Default and notes |
| --- | --- |
| `platform` | Required, "facebook" \| "tiktok" \| "linkedin" \| "google" |
| `id` | Required: an ad id on facebook and tiktok, the ad URL on linkedin and google |

Also takes `provider`, `max_credits`, `dry_run`: see [common parameters](https://www.manifoldmcp.com/docs/tools#common-parameters).

```json
{
  "platform": "facebook",
  "id": "1185617869915074"
}
```