Google Ads Transparency (anúncios)

Google Ads Transparency (anúncios): Anúncios que um anunciante roda no Google, por empresa, domínio ou palavra-chave.

Atualizado em 05/11/2026.

O que é Google Ads Transparency (anúncios) na APIcultura

Acesse Google Ads Transparency (anúncios) pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Anúncios que um anunciante roda no Google, por empresa, domínio ou palavra-chave. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: Anúncios. Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

Endpoint (slug)	O que faz	Preço por chamada	Rota
`google-anuncios-do-anunciante`	Anúncios de um anunciante	R$ 0,10	`POST /v1/call/google-anuncios-do-anunciante`
`google-anunciantes-por-palavra`	Anunciantes por palavra-chave (tarefa)	R$ 0,01	`POST /v1/call/google-anunciantes-por-palavra`
`google-anuncios-por-anunciante-tarefa`	Anúncios por anunciante (tarefa)	R$ 0,01	`POST /v1/call/google-anuncios-por-anunciante-tarefa`
`google-anuncios-da-empresa`	Anúncios de uma empresa por domínio	R$ 2,24	`POST /v1/call/google-anuncios-da-empresa`
`google-anuncios-na-busca`	Anúncios na página de busca	R$ 0,01	`POST /v1/call/google-anuncios-na-busca`

Anúncios de um anunciante (`google-anuncios-do-anunciante`)

Anúncios do Google de uma empresa ou domínio (Ads Transparency). Preço: R$ 0,10 por chamada.

company_domain (string, obrigatório), ex.: tesla.com
media_type (string, opcional)
continuation_token (string, opcional)
extract_text (boolean, opcional, padrão false)

Schema de entrada de google-anuncios-do-anunciante

{
  "required": [
    "company_domain"
  ],
  "properties": {
    "company_domain": {
      "type": "string",
      "maxLength": 2000
    },
    "media_type": {
      "type": "string",
      "maxLength": 2000
    },
    "continuation_token": {
      "type": "string",
      "maxLength": 2000
    },
    "extract_text": {
      "type": "boolean"
    }
  }
}

Anunciantes por palavra-chave (tarefa) (`google-anunciantes-por-palavra`)

Cria uma tarefa que lista anunciantes de uma palavra-chave. A leitura do resultado pede o identificador da tarefa. Preço: R$ 0,01 por chamada.

keyword (string, opcional), ex.: apple
priority (integer, opcional)
location_code (integer, opcional), ex.: 2840
pingback_url (string, opcional)
postback_url (string, opcional)
postback_data (string, opcional)
location_name (string, opcional)
location_coordinate (string, opcional)
tag (string, opcional)

Schema de entrada de google-anunciantes-por-palavra

{
  "required": [],
  "properties": {
    "keyword": {
      "type": "string",
      "maxLength": 2000
    },
    "priority": {
      "type": "number"
    },
    "location_code": {
      "type": "number"
    },
    "pingback_url": {
      "type": "string",
      "maxLength": 2000
    },
    "postback_url": {
      "type": "string",
      "maxLength": 2000
    },
    "postback_data": {
      "type": "string",
      "maxLength": 2000
    },
    "location_name": {
      "type": "string",
      "maxLength": 2000
    },
    "location_coordinate": {
      "type": "string",
      "maxLength": 2000
    },
    "tag": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Anúncios por anunciante (tarefa) (`google-anuncios-por-anunciante-tarefa`)

Cria uma tarefa que lista anúncios de um anunciante. A leitura do resultado pede o identificador da tarefa. Preço: R$ 0,01 por chamada.

advertiser_ids (array, opcional), ex.: AR13752565271262920705,AR02439908557932462081
target (string, opcional)
location_code (integer, opcional), ex.: 2840
depth (integer, opcional)
priority (integer, opcional)
pingback_url (string, opcional)
postback_url (string, opcional)
postback_data (string, opcional)
location_name (string, opcional)
location_coordinate (string, opcional)
tag (string, opcional)
platform (string, opcional), ex.: google_search
format (string, opcional)
date_from (string, opcional)
date_to (string, opcional)

Schema de entrada de google-anuncios-por-anunciante-tarefa

{
  "required": [],
  "properties": {
    "advertiser_ids": {
      "type": "array"
    },
    "target": {
      "type": "string",
      "maxLength": 2000
    },
    "location_code": {
      "type": "number"
    },
    "depth": {
      "type": "number"
    },
    "priority": {
      "type": "number"
    },
    "pingback_url": {
      "type": "string",
      "maxLength": 2000
    },
    "postback_url": {
      "type": "string",
      "maxLength": 2000
    },
    "postback_data": {
      "type": "string",
      "maxLength": 2000
    },
    "location_name": {
      "type": "string",
      "maxLength": 2000
    },
    "location_coordinate": {
      "type": "string",
      "maxLength": 2000
    },
    "tag": {
      "type": "string",
      "maxLength": 2000
    },
    "platform": {
      "type": "string",
      "maxLength": 2000
    },
    "format": {
      "type": "string",
      "maxLength": 2000
    },
    "date_from": {
      "type": "string",
      "maxLength": 2000
    },
    "date_to": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Anúncios de uma empresa por domínio (`google-anuncios-da-empresa`)

Anúncios do Google de uma empresa por domínio ou nome. Preço: R$ 2,24 por chamada (cada chamada inclui até 10 resultados).

company_domain (string, opcional), ex.: leadmagic.io
company_name (string, opcional)

Schema de entrada de google-anuncios-da-empresa

{
  "required": [],
  "properties": {
    "company_domain": {
      "type": "string",
      "maxLength": 2000
    },
    "company_name": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Anúncios na página de busca (`google-anuncios-na-busca`)

Anúncios pagos que aparecem no Google para uma consulta. Preço: R$ 0,01 por chamada.

q (string, obrigatório), ex.: coffee maker
location (string, obrigatório), ex.: Austin, Texas, United States
hl (string, opcional, padrão "en"), ex.: en
safe (string, opcional)
nfpr (string, opcional)
device (string, opcional, padrão "desktop"), ex.: desktop
timeout (number, opcional, máx. 90)

Schema de entrada de google-anuncios-na-busca

{
  "required": [
    "q",
    "location"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 2000
    },
    "location": {
      "type": "string",
      "maxLength": 2000
    },
    "hl": {
      "type": "string",
      "maxLength": 2000
    },
    "safe": {
      "type": "string",
      "maxLength": 2000
    },
    "nfpr": {
      "type": "string",
      "maxLength": 2000
    },
    "device": {
      "type": "string",
      "maxLength": 2000
    },
    "timeout": {
      "type": "number"
    }
  }
}

Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta call com o slug do endpoint e a entrada:

{ "name": "call", "arguments": { "slug": "google-anuncios-do-anunciante", "input": {"company_domain":"tesla.com"}, "max_cost_brl": 0.1 } }

Exemplo de chamada HTTP

curl -X POST https://api.apicultura.app/v1/call/google-anuncios-do-anunciante \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"company_domain":"tesla.com"}'

Formato da resposta, preço e limites

A resposta é JSON com data (o resultado do endpoint) e meta (inclui cost_brl, o valor cobrado). Preço deste endpoint: R$ 0,10 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use max_cost_brl para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

Workflows que usam Google Ads Transparency (anúncios)

Espionar um concorrente: anúncios ativos e criativos a partir do nome

Experimente

Teste no playground interativo: Google Ads Transparency (anúncios) no playground. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

Nota. Google Ads Transparency (anúncios) é marca de seus respectivos donos, citada apenas para identificar a integração.