API para Google Ads

API para Google Ads: Anúncios da empresa

Liste os anúncios que uma empresa está veiculando, a partir do Google Ads Transparency Center, por domínio ou ID de anunciante (ID do criativo, formato, URL do anúncio e datas da primeira e da última exibição), com paginação por cursor.

POST/v1/run/google_ads.company_ads
Disponibilidade
100,00%
30d · 911 chamadas
Requisições
911
30d · semanal, últimas 12 sem.
Resposta
1,1s
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": {
    "ads": [
      {
        "adUrl": "https://example.com/page",
        "advertiserId": "a1b2c3d4",
        "advertiserName": "Example title",
        "creativeId": "a1b2c3d4",
        "domain": "example.com",
        "firstShown": "example",
        "format": "example",
        "imageUrl": "https://example.com/image.jpg",
        "lastShown": "example"
      }
    ],
    "adsEstimate": 42,
    "nextCursor": "example"
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface GoogleAdsCompanyAdsResponse {
  data: {
    ads: {
      adUrl: string;
      advertiserId: string;
      advertiserName: string;
      creativeId: string;
      domain?: string;
      firstShown: string;
      format: string;
      imageUrl: string;
      lastShown: string;
    }[];
    adsEstimate: number;
    nextCursor: string | null;
  } | 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.company_ads
curl -X POST https://api.getanyapi.com/v1/run/google_ads.company_ads \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"lululemon.com"}'
CampoTipoValor de exemplo
Corpo da requisição
advertiserIdstringID do anunciante. Informe domain ou advertiserId.
cursorstringCursor de paginação opaco do nextCursor de uma resposta anterior.
domainstring"lululemon.com"Domínio da empresa (ex.: "lululemon.com"). Informe domain ou advertiserId.
endDatestringRetorna só anúncios exibidos pela primeira vez nesta data ou antes, no formato YYYY-MM-DD (ex.: 2024-12-31).
formatenumFiltro de formato do anúncio.
platformenumFiltro de plataforma.
regionstringCódigo de país de duas letras para limitar os resultados (ex.: "US", "AU").
startDatestringRetorna só anúncios exibidos pela primeira vez nesta data ou depois, no formato YYYY-MM-DD (ex.: 2024-01-01).
topicenumTema da busca. "political" exige uma region.
Resposta
dataobject
data.adsobject[]Populated whenever the provider has data for the entity.
data.ads[].adUrlstringPopulated whenever the provider has data for the entity.
data.ads[].advertiserIdstringPopulated whenever the provider has data for the entity.
data.ads[].advertiserNamestringPopulated whenever the provider has data for the entity.
data.ads[].creativeIdstringPopulated whenever the provider has data for the entity.
data.ads[].domainstringRegistrable domain the ad links to.
data.ads[].firstShownstringISO 8601 date.
data.ads[].formatstringPopulated whenever the provider has data for the entity.
data.ads[].imageUrlstring
data.ads[].lastShownstringISO 8601 date.
data.adsEstimateintegerEstimated total number of ads.
data.nextCursorstringOpaque cursor for the next page of ads, or null when this lane has no more. Pass it back as cursor to continue.
foundboolean
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çãoUSDUS$ 0,0012
Preço /mil req.USDUS$ 1,20

Dúvidas frequentes

Sobre o endpoint Anúncios da empresa da API para Google Ads

O endpoint Anúncios da empresa da AnyAPI para Google Ads retorna dados de Google Ads em JSON normalizado com uma chamada POST para /v1/run/google_ads.company_ads. Liste os anúncios que uma empresa está veiculando, a partir do Google Ads Transparency Center, por domínio ou ID de anunciante (ID do criativo, formato, URL do anúncio e datas da primeira e da última exibição), com paginação por cursor. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 1,20 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Anúncios da empresa da API para Google Ads feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,1 segundos, em 911 chamadas medidas.

Custa a partir de US$ 1,20 por mil requisições, 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.

Liste os anúncios que uma empresa está veiculando, a partir do Google Ads Transparency Center, por domínio ou ID de anunciante (ID do criativo, formato, URL do anúncio e datas da primeira e da última exibição), com paginação por cursor. 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, 100,0% das chamadas ao endpoint Anúncios da empresa da API para Google Ads feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,1 segundos, em 911 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.Buscara partir de US$ 1,37 /mil resultados