# Google advertiser search API

The Google advertiser search API finds advertisers in the Google Ads Transparency Center by name: ID, name, the country or region they are registered in, and the center's estimate of how many ads they have. The ID is what the advertiser's ads are asked for by. One call costs 2 credits ($0.004 to $0.0067 depending on the pack); failed calls are free. Call it over HTTP or from your AI client over MCP. Last tested 2026-10-17.

- Page: https://socialtoai.com/google-advertiser-search-api/
- Last updated: 2026-10-17
- Last tested: 2026-10-17

| Request | Price key | Credits |
| --- | --- | --- |
| `POST /v1/call/google.advertiser_search` | `google.advertiser_search` | 2 |

Preview: this interface is not marked stable yet, so its parameters and fields may still change. It is charged like any other call, and a failed call is not charged.

## Request

```bash
curl https://api.socialtoai.com/v1/call/google.advertiser_search \
  -H "Authorization: Bearer $SOCIALTOAI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "nike"
  }'
```

```python
import os
import requests

response = requests.post(
    "https://api.socialtoai.com/v1/call/google.advertiser_search",
    headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"},
    json={
        "query": "nike",
    },
)
print(response.json())
```

## Parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `query` | string | Required | — | Name of the advertiser or brand |
| `region` | string | Optional | — | The country or region to search in, by its two-letter code; the United States when left out |

First page only: up to 10 items, with no cursor parameter and no next page.

## Response fields

| Field | Type | Meaning | Given |
| --- | --- | --- | --- |
| `items[].title` | string | The entry's title or name. | yes |
| `items[].url` | string | A link that opens it; null where the platform's list has none. | yes |
| `items[].rank` | integer | Position on a board, from 1. | yes |
| `items[].heat` | integer | The platform's heat score. | yes |
| `items[].fields.region` | string | The code of the country or region the advertiser is registered in. | yes |

Every item also has platform, id, ref, approx and type; the response around the items is the same on every call. [Response format](https://socialtoai.com/docs/api/response.md)

## Sample response

Sample data: names, links and text are replaced by placeholders; the numbers are as recorded.

```json
{
  "request_id": "req_00000000-0000-4000-8000-000000000001",
  "schema_version": "v1",
  "fetched_at": "2026-10-12T21:58:56.000Z",
  "action": "call",
  "op": "google.advertiser_search",
  "platform": "google",
  "status": "ok",
  "items": [
    {
      "platform": "google",
      "id": "…",
      "ref": "…",
      "approx": [],
      "type": "entry",
      "entry_type": "advertiser",
      "title": "…",
      "url": null,
      "rank": null,
      "heat": null,
      "fields": {
        "region": "…"
      }
    }
  ],
  "unavailable": [],
  "page": {
    "has_more": false
  },
  "warnings": [],
  "applied_params": {
    "query": "nike"
  },
  "cost_credits": 2,
  "billing": {
    "cost_credits": 2,
    "balance_credits": 98,
    "today_spend_credits": 2,
    "daily_limit_credits": null,
    "daily_remaining_credits": null,
    "display": "This call: 2 credits. Balance: 98 credits."
  },
  "replayed": false
}
```

## Paging and failures

- One call returns the first page only, up to 10 items, with no cursor, for 2 credits.
- A call that runs and finds nothing is a successful call: status is "empty", items is empty, and it costs 2 credits.
- 1 call per second per key, 5 after a purchase; going over is not charged. [Rate limits](https://socialtoai.com/docs/credits-and-billing.md#rate-limits)
- A failed call costs 0 credits and is never retried on its own. [Error codes](https://socialtoai.com/docs/api/errors.md)

## Ask your AI

- Find advertisers in the Google Ads Transparency Center by name: nike. → `call {"op":"google.advertiser_search","query":"nike"}`, 2 credits

## The same call on other platforms

| Platform | Price key | Credits | Page |
| --- | --- | --- | --- |
| Meta Ad Library | `meta.advertiser_search` | 2 | https://socialtoai.com/meta-advertiser-search-api.md |

## More on Google Ads Transparency

| Interface | What it does | Price key | Credits | Page |
| --- | --- | --- | --- | --- |
| `advertiser_ads` | Get an advertiser's ads from the Google Ads Transparency Center, by the advertiser's ID. | `google.advertiser_ads` | 2 | https://socialtoai.com/google-advertiser-ads-api.md |
| `ad_detail` | Get one ad of the Google Ads Transparency Center by its ID or link. | `google.ad_detail` | 2 | https://socialtoai.com/google-ad-detail-api.md |

## FAQ

**Do I need a Google Ads Transparency account or Google Ads Transparency's own API access?**

No. You only need a SocialToAI key. The call returns content and account information publicly visible on Google Ads Transparency; you never sign in to Google Ads Transparency or apply for anything there.

**Can I get the next page?**

No. On Google Ads Transparency this interface gives its first page only (up to 10 items): the response carries no cursor, and page.has_more is always false.

**What does “Preview” mean here?**

Preview: this interface is not marked stable yet, so its parameters and fields may still change. It is charged like any other call, and a failed call is not charged.