# Google Ads Transparency Advertisers API Documentation

Search advertisers and domains by name or text. Returns both record kinds the source publishes: advertisers with their identifier, country, ad count and active flag, and matching domains. Pass resolve_domain=1 to also collapse a supplied domain to its registrable parent, ready to hand to the ads route. This is string work and costs no extra upstream lookup; looking the advertiser id up is a separate request. A blocked or unanswered upstream lookup fails without consuming credits.

- **Documentation:** [https://scrappa.co/docs/google-ads-transparency-api/google_ads_transparency_advertisers](https://scrappa.co/docs/google-ads-transparency-api/google_ads_transparency_advertisers)
- **API group:** Google Ads Transparency API
- **Endpoint:** `GET https://scrappa.co/api/google-ads-transparency/advertisers`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | Yes | Search text. Alias: query. |
| `limit` | integer | No | Results to return. Defaults to 20, maximum 100. The upstream count degrades to an empty envelope above 100 rather than reporting an error, so a larger page would be billed as an empty success. |
| `resolve_domain` | boolean | No | Set true to also collapse a domain to its registrable parent and report it as domain_resolution.resolved. No advertiser id is resolved for it: looking one up is a separate request. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/google-ads-transparency/advertisers?q=nike&limit=20"
```

## Example response

```json
{
    "success": true,
    "data": {
        "advertisers": [],
        "domains": []
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | The advertiser could not be confirmed or the upstream service refused the request. Not billed. |  |
| 422 | The request validation failed. Not billed. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)