SerpApiGoogleSEO/AEO

Google advertiser's running ads — Ads Transparency Center

serpapi.google.ads.transparency

Ads a Google advertiser is running now, from the Ads Transparency Center

Price: $0.015/successPelo preço do provedor
Success rate: 100%Last 30 days · 2.416 calls
Latency p50: 2.5 sp95 11 s
Last verified: 28 de jul. de 2026Verified working

GEThttps://toolswitch.dev/v1/tools/serpapi.google.ads.transparency?text=coffee&engine=google_ads_transparency_centerPreview

Try onlineEm breveProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parâmetros

answers arrive in `ad_creatives`. This is the one endpoint in the file whose query param is `text` rather than `q` — and it is optional, because you may identify the advertiser by id instead.

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Parâmetros de consulta
`num`	inteiro	Opcional	results to return; default 40. Unlike engine=google, `num` IS documented here	`10`
`text`	string	Opcional	free-text advertiser or domain to search for. Supply either this OR advertiser_id — neither is individually mandatory but one is needed	`coffee`
`engine`	string	Obrigatório		`google_ads_transparency_center`
`region`	string	Opcional	geographic region the search originates from. REQUIRED when political_ads is true
`end_date`	string	Opcional	YYYYMMDD
`platform`	string	Opcional	where the ad ran: PLAY \| MAPS \| SEARCH \| SHOPPING \| YOUTUBE
`start_date`	string	Opcional	YYYYMMDD
`advertiser_id`	string	Opcional	a specific advertiser id, or several comma-separated
`political_ads`	booleano	Opcional	restrict to political advertising; forces `region` to be set
`creative_format`	string	Opcional	text \| image \| video
`next_page_token`	string	Opcional	cursor from the previous response's serpapi_pagination

Parâmetros de consulta
numinteiroOpcional
results to return; default 40. Unlike engine=google, `num` IS documented here
Exemplo: 10
textstringOpcional
free-text advertiser or domain to search for. Supply either this OR advertiser_id — neither is individually mandatory but one is needed
Exemplo: coffee
enginestringObrigatório
Exemplo: google_ads_transparency_center
regionstringOpcional
geographic region the search originates from. REQUIRED when political_ads is true
end_datestringOpcional
YYYYMMDD
platformstringOpcional
where the ad ran: PLAY | MAPS | SEARCH | SHOPPING | YOUTUBE
start_datestringOpcional
YYYYMMDD
advertiser_idstringOpcional
a specific advertiser id, or several comma-separated
political_adsbooleanoOpcional
restrict to political advertising; forces `region` to be set
creative_formatstringOpcional
text | image | video
next_page_tokenstringOpcional
cursor from the previous response's serpapi_pagination

Exemplos de código

Substitua $TOOLSWITCH_KEY pela chave criada no console.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/serpapi.google.ads.transparency?text=coffee&engine=google_ads_transparency_center' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/serpapi.google.ads.transparency?text=coffee&engine=google_ads_transparency_center",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/serpapi.google.ads.transparency?text=coffee&engine=google_ads_transparency_center", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a $0.015/success, incluindo a taxa de serviço.