# 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.

URL: https://apicultura.app/ferramentas/google-transparencia-anuncios/
Atualizado em 05/11/2026 (2026-11-05).

## 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](/catalogo/?cat=anuncios). 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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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:

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

## Exemplo de chamada HTTP

```bash
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](/workflows/espionar-concorrente/)

## Experimente

Teste no playground interativo: [Google Ads Transparency (anúncios) no playground](/ferramentas/ferramenta.html?slug=google-transparencia-anuncios). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

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