# Google Ads Transparency advertiser search API

> Find advertisers in the Google Ads Transparency Center by name: advertiser ID, the name Google verified, the country it is registered in and the center's estimate of how many ads it has. The verified name is often the legal entity, not the brand.

Canonical page: https://okdata.online/apis/google/advertisers/search/

- **Endpoint**: `GET /v1/google/advertisers/search`
- **ID**: `google.advertisers.search`
- **Price**: $0.004 per call · about 10 advertisers per page
- **Returns**: a page of about 10 advertisers (`data.items`, Advertiser objects)
- **Status**: beta
- **Good for**: Ad intelligence

## Price

One call costs $0.004 and returns one page of about 10 advertisers. Collecting 1,000 advertisers takes about 100 calls, $0.40 in total. Each page is a separate call; failed calls are not charged.

## Parameters

| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| `query` | string | yes |  | Keywords, as a person would type them into the platform search box. (e.g. `Stanley`) |
| `country` | string | no |  | Country to search in (ISO code); US by default. (e.g. `US`) |
| `cursor` | string | no |  | Opaque cursor from page.next_cursor of the previous call. Each page is a separate call. |
| `view` | string: compact / standard / full | no | `standard` | How much of each object comes back. full adds platform-specific fields under ext. |
| `fields` | string | no |  | Comma-separated fields to keep, to save tokens. |

cursor, view and fields work as described in [Requests](https://okdata.online/docs/requests/).

## Returned fields

Each item is a [Advertiser](https://okdata.online/docs/objects/advertiser/).

| Field | Type | Description |
|---|---|---|
| `id` | string | Advertiser ID in the library. |
| `url` | string | The advertiser's page in the library. |
| `name` | string | The name the library shows, often the legal entity. |
| `region` | string \| null | Country or region it is registered in (ISO code). |
| `ads` | integer \| null | The library's estimate of how many ads it has. |
| `ext` | object | Platform-specific extras. Only returned with view=full. |

## Request examples

### cURL

```bash
curl -G "https://api.okdata.online/v1/google/advertisers/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query=Stanley'
```

### Python

```python
import os
import requests

resp = requests.get(
    "https://api.okdata.online/v1/google/advertisers/search",
    headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"},
    params={"query": "Stanley"},
    timeout=60,
)
body = resp.json()
if body["code"] != "ok":
    raise RuntimeError(f"{body['code']}: {body['message']} (charged: {body['charged']})")

for row in body["data"]["items"]:
    print(row["id"], row["name"], row["ads"])
print("cost: $" + body["meta"]["billing"]["amount"])
```

### TypeScript

```ts
const url = new URL('https://api.okdata.online/v1/google/advertisers/search');
url.searchParams.set('query', "Stanley");

const res = await fetch(url, {
  headers: {
    Authorization: `Bearer ${process.env.OKDATA_API_KEY}`,
  },
});
const body = await res.json();
if (body.code !== 'ok') throw new Error(`${body.code}: ${body.message}`);

for (const row of body.data.items) {
  console.log(row.id, row.name, row.ads);
}
console.log('cost: $' + body.meta.billing.amount);
```

### MCP

```json
{
  "name": "call",
  "arguments": {
    "endpoint": "google.advertisers.search",
    "params": {
      "query": "Stanley"
    }
  }
}
```

Or ask an agent that has the MCP server connected:

> Use Google Ads Transparency advertiser search and find the advertiser ID of this brand.

## Response example

```json
{
  "code": "ok",
  "request_id": "0f6c2a8e-4b1d-4e0a-9a51-3c7d2b9e1f20",
  "data": {
    "items": [
      {
        "id": "AR17172796163137470465",
        "url": "https://adstransparency.google.com/advertiser/AR17172796163137470465",
        "name": "PACIFIC MARKET INTERNATIONAL, LLC",
        "region": "US",
        "ads": 2000
      }
    ]
  },
  "page": {
    "next_cursor": "eyJvIjoyMH0",
    "has_more": true
  },
  "warnings": [],
  "meta": {
    "capability": "google.advertisers.search",
    "billing": {
      "amount": "0.004",
      "currency": "USD",
      "balance_after": "9.996"
    },
    "unavailable": {},
    "cached": false,
    "replayed": false,
    "fetched_at": "2026-11-11T08:00:00Z"
  }
}
```

## Errors

Errors share one shape and are never charged, except a timeout, whose charge is unknown until looked up. The full table: https://okdata.online/docs/errors/

## Questions

### How much does the Google Ads Transparency advertiser search API cost?

One call costs $0.004 and returns one page of about 10 advertisers. Collecting 1,000 advertisers takes about 100 calls, $0.40 in total. Each page is a separate call; failed calls are not charged.

### How do I get the next page?

Pass page.next_cursor from the response back as the cursor parameter. When page.has_more is false there is nothing left. Every page is its own call at $0.004.

### Do I need a Google Ads Transparency account, cookies or a QR login?

No. You send only your okdata API key. The data is public data from Google Ads Transparency; nothing is fetched with your own Google Ads Transparency account.

### Am I charged when a call fails?

No. Every error response says charged: false, except a timeout, which says charged: null until the outcome is known. Resend with the same Idempotency-Key and you are never charged twice.

### What if Google Ads Transparency does not show a field?

The field is null, and meta.unavailable names it with the reason: platform (the platform never shows it) or capability (we cannot fetch it yet).

## More Google Ads Transparency endpoints

- [Google advertiser ads](https://okdata.online/apis/google/advertisers/ads/list/): $0.004 per call · about 40 ads per page

## Answers that use this endpoint

- [How do I see all the ads a competitor is running on Meta, Google and TikTok?](https://okdata.online/answers/competitor-ads-meta-google-tiktok/): Query each public ad library under the name the competitor has there (its Facebook page on Meta, its website domain on Google, its advertiser name in TikTok's library) and merge the results into one table. With okdata a weekly sweep of one competitor costs $0.028, and ten competitors every week for a month cost $1.12.
- [How do I export a competitor's ads from the Google Ads Transparency Center?](https://okdata.online/answers/export-google-ads-transparency-center/): The Transparency Center website has no export button and Google publishes no API for it; its BigQuery dataset only covers ads shown in the EEA and Turkey. okdata finds the advertiser for $0.004 and lists its ads 40 per page for $0.004, so exporting an advertiser with 600 ads costs $0.064.