# Google Ads Transparency Center API

> Ads an advertiser is running on Google, from the Ads Transparency Center: creatives, formats, first and last shown dates.

Source: https://www.sandbase.ai/apis/google/ads-transparency
API reference: https://www.sandbase.ai/apis/google/ads-transparency/docs

## Facts

- Provider: Google
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/google/ads-transparency`
- Price: $0.01 per call
- Capabilities: api, google, ads
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/google/ads-transparency` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `text` | string | no |  |
| `advertiser_id` | string | no |  |
| `region` | string | no |  |
| `political_ads` | boolean | no |  |
| `platform` | string | no |  |
| `creative_format` | string | no |  |
| `start_date` | string | no |  |
| `end_date` | string | no |  |
| `num` | integer | no |  |
| `next_page_token` | string | no |  |

## FAQ

### How do I use the Google Ads Transparency Center API?

Send a POST request to https://api.sandbase.ai/v1/api/google/ads-transparency with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Google Ads Transparency Center API cost?

$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Google Ads Transparency Center API accept?

No parameters are required. Optional: text (string), advertiser_id (string), region (string), political_ads (boolean), platform (string) and creative_format (string) and 4 more. The Parameters table and the Playground on this page list every field.

### What does the Google Ads Transparency Center API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Google developer account or API key?

No. Google Ads Transparency Center runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Google API access separately.

## README

### Google Ads Transparency Center API

Ads an advertiser is running on Google, from the Ads Transparency Center: creatives, formats, first and last shown dates.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/google/ads-transparency" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "apple.com"}'
```

The result is returned in `outputs[0].data`.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `advertiser_id` | string | No | a specific advertiser id, or several comma-separated |
| `creative_format` | string | No | text / image / video |
| `end_date` | string | No | YYYYMMDD |
| `next_page_token` | string | No | cursor from the previous response's serpapi_pagination |
| `num` | integer | No | results to return; default 40. Unlike engine=google, `num` IS documented here |
| `platform` | string | No | where the ad ran: PLAY / MAPS / SEARCH / SHOPPING / YOUTUBE |
| `political_ads` | boolean | No | restrict to political advertising; forces `region` to be set |
| `region` | string | No | geographic region the search originates from. REQUIRED when political_ads is true |
| `start_date` | string | No | YYYYMMDD |
| `text` | string | No | free-text advertiser or domain to search for. Supply either this OR advertiser_id — neither is individually mandatory but one is needed |

#### Pricing

Flat price per call. Failed calls are not charged.