# Adstransparency Google — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for advertisers and their advertisements to view ad copy, creative formats, advertiser details, geographic targeting, and active date ranges across Google's ad ecosystem. Access detailed information about specific ads including direct links and comprehensive advertiser profiles all in one place.

**Category:** Business Directories | **Website:** [adstransparency.google.com/?region=US](https://adstransparency.google.com/?region=US) | **Docs:** [parse.bot/marketplace/9b995d7f-f598-4dfa-986f-3fea55bfc34c/adstransparency-google-com-api](https://parse.bot/marketplace/9b995d7f-f598-4dfa-986f-3fea55bfc34c/adstransparency-google-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-adstransparency-google-com-api-9b995d7f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_ad_details

Get detailed information about a specific ad creative, including all ad variants, regions where it was shown, and advertiser legal name. Requires both advertiser_id and creative_id, typically obtained from a search_ads result.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `advertiser_id` | string | Yes | Advertiser ID (e.g. AR16735076323512287233) |
| `creative_id` | string | Yes | Creative ID (e.g. CR02693044172193005569) |
| `region` | string | No | 2-letter country code |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-adstransparency-google-com-api-9b995d7f/get_ad_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"advertiser_id":"<string>","creative_id":"<string>","region":"<string>"}'
```

### search_ads

Search for ad creatives by advertiser name or advertiser ID. Automatically finds the best-matching advertiser (by ad count) when searching by name. Supports cursor-based pagination via next_page_token. Returns ad summaries including format, text, image URL, and date ranges.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `advertiser_id` | string | No | Direct advertiser ID (e.g. AR16735076323512287233). Skips advertiser lookup when provided. |
| `limit` | integer | No | Number of ads to return per page (max 40) |
| `page_token` | string | No | Pagination token from a previous response's next_page_token field |
| `query` | string | No | Advertiser name to search for. Either query or advertiser_id is required. |
| `region` | string | No | 2-letter country code to filter ads by region |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-adstransparency-google-com-api-9b995d7f/search_ads \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"advertiser_id":"<string>","limit":"<integer>","page_token":"<string>","query":"<string>","region":"<string>"}'
```

### search_advertisers

Search for advertisers by name. Returns a list of matching advertisers with their IDs, countries, and ad counts. Use the advertiser_id from results to navigate to their ads via the ads sub-resource.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of advertiser suggestions to return (max 20) |
| `query` | string | Yes | Advertiser name to search for |
| `region` | string | No | 2-letter country code (e.g. US, GB, DE, FR, IT, ES, JP, BR, IN, CA, AU) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-adstransparency-google-com-api-9b995d7f/search_advertisers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>","region":"<string>"}'
```