API para Google Ads

API para Google Ads: Buscar

Obtenha os anúncios que um anunciante está veiculando agora, a partir do Google Ads Transparency Center (detalhes do criativo, formatos e datas de veiculação), em JSON limpo.

POST/v1/run/google_ads.search
Disponibilidade
99,42%
30d · 173 chamadas
Requisições
173
30d
Resposta
11,8s
mediana · 30d

Preços

Um preço, em dólares

Teste

Faça sua primeira requisição

Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "data": {
    "items": [
      {
        "advertiser": "example",
        "advertiserId": "a1b2c3d4",
        "firstShownUtc": 12.5,
        "format": "example",
        "id": "a1b2c3d4",
        "lastShownUtc": 12.5,
        "numServedDays": 42,
        "previewUrl": "https://example.com/page",
        "url": "https://example.com/page",
        "variations": [
          {
            "headline": "Example title",
            "imageUrl": "https://example.com/image.jpg",
            "text": "A short example description of this item."
          }
        ]
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface GoogleAdsSearchResponse {
  data: {
    items: {
      advertiser?: string;
      advertiserId?: string;
      firstShownUtc?: number;
      format?: string;
      id: string;
      lastShownUtc?: number;
      numServedDays?: number;
      previewUrl?: string;
      url: string;
      variations?: {
        headline?: string;
        imageUrl?: string;
        text?: string;
      }[];
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d
POST /v1/run/google_ads.search
curl -X POST https://api.getanyapi.com/v1/run/google_ads.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"url":"https://adstransparency.google.com/?region=US&domain=nike.com"}'
CampoTipoValor de exemplo
Corpo da requisição
urlstring"https://adstransparency.google.com/?region=US&domain=nike.com"Uma URL do Google Ads Transparency Center de um anunciante ou domínio selecionado (ex.: https://adstransparency.google.com/advertiser/AR01614014350098432001?region=US).
limitinteger3Número máximo de resultados a retornar (1-20, padrão 20). A cobrança é por resultado retornado, então um limite menor custa menos.
Resposta
dataobjectThe result wrapper, or null when nothing was found.
data.itemsobject[]Ad records from the Transparency Center: advertiser, ad format, creative details, preview URL, and first/last shown dates. Populated whenever the provider has data for the entity.
data.items[].advertiserstringAdvertiser display name. Populated whenever the provider has data for the entity.
data.items[].advertiserIdstringGoogle Ads advertiser identifier.
data.items[].firstShownUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was first shown.
data.items[].formatstringAd format, e.g. TEXT, IMAGE, VIDEO.
data.items[].idstringGoogle Ads creative identifier. Populated whenever the provider has data for the entity.
data.items[].lastShownUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. When the ad was last shown.
data.items[].numServedDaysintegerNumber of days the ad has been served.
data.items[].previewUrlstringURL to a rendered preview of the creative.
data.items[].urlstringAds Transparency Center URL for the creative. Populated whenever the provider has data for the entity.
data.items[].variationsobject[]Creative variations for the ad, each with image, headline, and body text where present.
data.items[].variations[].headlinestringCreative headline text.
data.items[].variations[].imageUrlstringCreative image URL.
data.items[].variations[].textstringCreative body/description text.
foundbooleanTrue when at least one ad record was returned.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preço
Preço por requisição (teto)USDUS$ 0,0287
Preço /mil resultadosUSDUS$ 1,37

Dúvidas frequentes

Sobre o endpoint Buscar da API para Google Ads

O endpoint Buscar da AnyAPI para Google Ads retorna dados de Google Ads em JSON normalizado com uma chamada POST para /v1/run/google_ads.search. Obtenha os anúncios que um anunciante está veiculando agora, a partir do Google Ads Transparency Center (detalhes do criativo, formatos e datas de veiculação), em JSON limpo. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa US$ 1,37 por mil resultados, e nunca mais de US$ 0,0287 por requisição, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 99,4% das chamadas ao endpoint Buscar da API para Google Ads feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 11,8 segundos, em 173 chamadas medidas.

Custa US$ 1,37 por mil resultados, e nunca mais de US$ 0,0287 por requisição, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Obtenha os anúncios que um anunciante está veiculando agora, a partir do Google Ads Transparency Center (detalhes do criativo, formatos e datas de veiculação), em JSON limpo. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 99,4% das chamadas ao endpoint Buscar da API para Google Ads feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 11,8 segundos, em 173 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.
Mais para chamar

Outros endpoints de Google Ads

Detalhes do anúncioa partir de US$ 1,20 /mil req.Busca de anunciantesa partir de US$ 1,20 /mil req.Anúncios da empresaa partir de US$ 1,20 /mil req.