Start building

Google Ads Transparency Center API docs

Open Playground →

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/google/ads-transparency
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/google/ads-transparency" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "text": "apple.com"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

2. Authentication

Set your SandBase API key in your server environment. Requests use Bearer authentication.

API key environment variable
export SANDBASE_API_KEY="YOUR_API_KEY"

Keep your key on the server. Do not expose it in browser code.

3. Parameters

textstring

free-text advertiser or domain to search for. Supply either this OR advertiser_id — neither is individually mandatory but one is needed

advertiser_idstring

a specific advertiser id, or several comma-separated

regionstring

geographic region the search originates from. REQUIRED when political_ads is true

political_adsboolean

restrict to political advertising; forces `region` to be set

platformstring

where the ad ran: PLAY | MAPS | SEARCH | SHOPPING | YOUTUBE

creative_formatstring

text | image | video

start_datestring

YYYYMMDD

end_datestring

YYYYMMDD

numinteger

results to return; default 40. Unlike engine=google, `num` IS documented here

next_page_tokenstring

cursor from the previous response's serpapi_pagination

4. Response

Saved example response for this API; no live request is made when viewing it.

No saved response has been published. Run the API in Playground to inspect its response.