# Adstransparency Google — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/adstransparency-google/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/adstransparency-google/get-ad-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/adstransparency-google/search-ads \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/adstransparency-google/search-advertisers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>","region":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.