# Google Ads API Scraper - Busca Anúncios por Empresa ou Domínio (`brasildados/google-ads-api-anuncios-scraper`) Actor

Busque anúncios no Google Ads por empresa, marca ou domínio. Escolha a plataforma e a quantidade de resultados para encontrar criativos exibidos no Brasil.

- **URL**: https://apify.com/brasildados/google-ads-api-anuncios-scraper.md
- **Developed by:** [BrasilDados.org](https://apify.com/brasildados) (community)
- **Categories:** E-commerce, SEO tools, Integrations
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $80.00 / 1,000 anúncio encontrados

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### 🔎 O que é o Google Ads API Scraper?

Busque **anúncios no Google Ads por empresa, marca ou domínio**. Encontre criativos de texto, imagem e vídeo exibidos no Brasil, identifique anunciantes e acompanhe quando cada campanha começou ou foi vista pela última vez.

O Actor funciona como uma **Google Ads Transparency API** para consultar dados públicos do **Google Ads Transparency Center**. Pesquise por empresa, marca ou domínio, escolha a plataforma e defina a quantidade de resultados. Exporte uma linha organizada por anúncio em **JSON, CSV ou Excel** ou conecte o Actor à API da Apify, Make, Zapier, n8n e outros fluxos de automação.

> **Entrada simples:** informe uma marca como `Nubank` ou um domínio como `nubank.com.br`. A região Brasil já vem configurada.

### O que este Google Ads Scraper faz?

- Pesquisa anúncios por **empresa, marca ou domínio**.
- Busca automaticamente anúncios exibidos no **Brasil**.
- Encontra criativos de **texto, imagem e vídeo**.
- Enriquece cada anúncio com campos calculados e links públicos, sem consultas individuais adicionais.
- Filtra por Pesquisa Google, YouTube, Shopping, Maps ou Play.
- Informa a primeira e a última data de exibição disponíveis.
- Calcula quantos dias o anúncio ficou em exibição.
- Remove anúncios duplicados pelo identificador do criativo.
- Exporta dados planos e fáceis de usar em planilhas.

### 🎯 Para quem é este Actor?

#### Agências de marketing

Descubra quais criativos e canais outras marcas estão utilizando antes de planejar campanhas para seus clientes.

#### E-commerce e gestores de tráfego

Monitore anúncios de lojas concorrentes, lançamentos, promoções e mudanças na estratégia de mídia.

#### Inteligência competitiva

Monte uma biblioteca de anúncios por empresa e acompanhe criativos novos ou campanhas de longa duração com execuções agendadas.

#### Pesquisa de mercado

Compare anunciantes, formatos, domínios de destino e períodos de veiculação em um conjunto estruturado de dados.

### ⚙️ Entrada

Somente o campo **Empresa, marca ou domínio** é obrigatório.

| Campo | Obrigatório | Descrição | Exemplo |
|---|---:|---|---|
| `search` | Sim | Empresa, marca ou domínio pesquisado | `nubank.com.br` |
| `maxResults` | Não | Quantidade máxima de anúncios, de 1 a 1.000 | `100` |
| `platform` | Não | `all`, `SEARCH`, `YOUTUBE`, `SHOPPING`, `MAPS` ou `PLAY` | `YOUTUBE` |

#### Exemplo simples

```json
{
  "search": "nubank.com.br",
  "maxResults": 100
}
```

#### Buscar anúncios exibidos no YouTube

```json
{
  "search": "mercadolivre.com.br",
  "maxResults": 200,
  "platform": "YOUTUBE"
}
```

### 📦 Saída

Cada anúncio ocupa uma linha no Dataset.

| Campo | Descrição |
|---|---|
| `advertiser` | Nome público do anunciante |
| `advertiserId` | Identificador do anunciante no Google |
| `creativeId` | Identificador único do criativo |
| `format` | Formato do anúncio: texto, imagem ou vídeo |
| `width` | Largura do criativo em pixels, quando disponível |
| `height` | Altura do criativo em pixels, quando disponível |
| `aspectRatio` | Proporção simplificada do criativo, como `16:9` ou `1:1` |
| `orientation` | Orientação calculada: `landscape`, `portrait` ou `square` |
| `targetDomain` | Domínio de destino identificado |
| `firstShown` | Primeira exibição disponível |
| `lastShown` | Última exibição disponível |
| `daysShown` | Dias entre a primeira e a última exibição |
| `mediaUrl` | URL técnica do conteúdo ou preview; pode ser um script de renderização, não uma mídia direta |
| `adUrl` | Link do anúncio no Ads Transparency Center |
| `advertiserUrl` | Link para a página pública do anunciante |
| `googleAdsTransparencyCenterUrl` | Link da pesquisa na Central de Transparência do Google Ads |
| `platform` | Plataforma pesquisada ou `all` quando não houver filtro |
| `resultPosition` | Posição do anúncio no resultado normalizado |
| `page` | Página da consulta em que o anúncio foi encontrado |
| `totalResults` | Total de resultados informado pela fonte, quando disponível |
| `search` | Termo utilizado na pesquisa |
| `country` | País consultado, sempre `Brazil` nesta versão |
| `collectedAt` | Data e hora da coleta |

#### Exemplo de resultado

```json
{
  "advertiser": "NU PAGAMENTOS S.A.",
  "advertiserId": "AR00000000000000000000",
  "creativeId": "CR00000000000000000000",
  "format": "image",
  "width": 1200,
  "height": 628,
  "aspectRatio": "300:157",
  "orientation": "landscape",
  "targetDomain": "nubank.com.br",
  "firstShown": "2026-01-10T00:00:00.000Z",
  "lastShown": "2026-02-08T00:00:00.000Z",
  "daysShown": 30,
  "mediaUrl": "https://example.com/creative.jpg",
  "adUrl": "https://adstransparency.google.com/advertiser/.../creative/...",
  "advertiserUrl": "https://adstransparency.google.com/advertiser/...",
  "googleAdsTransparencyCenterUrl": "https://adstransparency.google.com/?region=BR&query=nubank.com.br",
  "platform": "all",
  "resultPosition": 1,
  "page": 1,
  "totalResults": 125,
  "search": "nubank.com.br",
  "country": "Brazil",
  "collectedAt": "2026-08-12T00:00:00.000Z"
}
```

### 🚀 Executar em Batch ou Standby

Os dois modos usam os mesmos campos e retornam os mesmos anúncios. Você fornece somente o token da Apify; nenhuma credencial do Google ou da fonte de dados é necessária.

#### Batch

Use Batch para buscas maiores, execuções agendadas e resultados armazenados no Dataset.

```bash
curl -X POST \
  "https://api.apify.com/v2/acts/brasildados~google-ads-api-anuncios-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"search":"nubank.com.br","maxResults":100}'
```

Cada anúncio é gravado como uma linha no Dataset, que pode ser exportado em JSON, CSV, Excel ou XML.

#### Standby

Use Standby quando seu sistema precisar receber os resultados diretamente por HTTP, sem consultar o Dataset. O Actor possui um único endpoint público.

```bash
curl -X POST \
  "https://brasildados--google-ads-api-anuncios-scraper.apify.actor/search" \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"search":"nubank.com.br","maxResults":100,"platform":"all"}'
```

No Standby, a resposta é um array de anúncios com objetos planos, no mesmo formato das linhas do Dataset. Para operações que possam levar mais de cinco minutos, prefira Batch.

### Ideias de automação

1. Agende uma execução diária ou semanal para cada concorrente.
2. Envie o Dataset para Google Sheets, banco de dados ou data warehouse.
3. Compare `creativeId` com a execução anterior.
4. Gere alertas quando aparecerem novos criativos.
5. Analise formatos, duração e domínios usados pela concorrência.

### Preço e controle de custo

O Actor utiliza cobrança **Pay per event (PPE)**. Cada evento `result-item` corresponde a **um anúncio retornado**.

O Actor usa somente a consulta principal, que pode retornar até 100 anúncios por página. Campos adicionais são calculados a partir dessa mesma resposta, sem abrir individualmente os links dos anúncios.

Resultados duplicados, registros descartados e buscas sem anúncios não geram cobrança por resultado. O usuário pode definir um limite máximo de custo; quando ele é atingido, o Actor interrompe a entrega de novos anúncios.

### ⚠️ Limitações importantes

- Os resultados dependem do conteúdo público disponível no Google Ads Transparency Center.
- Uma pesquisa por nome pode encontrar empresas diferentes com nomes semelhantes.
- Para maior precisão, prefira pesquisar pelo domínio oficial da empresa.
- Nem todo anúncio possui domínio, imagem ou todas as datas disponíveis.
- Dados de orçamento, gasto, segmentação e impressões não estão disponíveis para todos os anúncios.
- `daysShown` representa o intervalo entre as datas públicas disponíveis; não comprova exibição contínua em todos os dias.
- `mediaUrl` é um campo técnico mantido no JSON completo. Ele pode apontar para uma imagem, vídeo, preview ou script de renderização e, por isso, não aparece na visualização principal do Dataset.

### ❓ Perguntas frequentes

#### O que é uma Google Ads Transparency API?

É uma forma estruturada de pesquisar anúncios públicos da Central de Transparência do Google Ads. Este Actor recebe uma empresa, marca ou domínio e retorna os anúncios encontrados em dados prontos para integração.

#### Preciso de uma conta do Google Ads?

Não. Você precisa somente de uma conta e um token da Apify para executar o Actor pela API.

#### Posso pesquisar anúncios de qualquer empresa?

Sim, desde que o anúncio esteja disponível publicamente no Google Ads Transparency Center. Pesquisar o domínio oficial costuma gerar resultados mais precisos.

#### O Actor mostra quanto o concorrente gastou?

Não para anúncios comerciais comuns. Algumas métricas aparecem apenas em categorias e regiões específicas, especialmente publicidade política, e não fazem parte da saída simples desta versão.

#### Posso monitorar anúncios novos?

Sim. Agende execuções recorrentes e compare o campo `creativeId`. Um identificador ainda não visto representa um novo criativo no seu histórico.

#### Posso exportar para Excel?

Sim. Na aba Dataset, escolha XLSX, CSV, JSON ou XML.

#### A busca é limitada ao Brasil?

Sim. Este Actor foi desenhado para Google Ads Brasil e aplica automaticamente a região brasileira.

### Aviso legal

Este Actor acessa informações públicas para pesquisa e inteligência competitiva. Ele não é afiliado, patrocinado ou endossado pelo Google. Google Ads e as demais marcas citadas pertencem aos seus respectivos titulares. O usuário é responsável por utilizar os dados conforme as leis e os termos aplicáveis.

***

**Google Ads API Scraper — Busca Anúncios por Empresa ou Domínio** transforma pesquisas manuais na Central de Transparência em dados estruturados, exportáveis e prontos para automação.

# Actor input Schema

## `search` (type: `string`):

Exemplos: Nike, Nubank ou nike.com

## `maxResults` (type: `integer`):

O Actor encerra ao atingir esta quantidade.

## `platform` (type: `string`):

Opcional. Escolha Todas para buscar anúncios em qualquer plataforma.

## Actor input object example

```json
{
  "search": "nubank.com.br",
  "maxResults": 100,
  "platform": "all"
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset com um registro plano por anúncio, incluindo anunciante, criativo, domínio, datas, dimensões, plataforma e links públicos.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("brasildados/google-ads-api-anuncios-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("brasildados/google-ads-api-anuncios-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call brasildados/google-ads-api-anuncios-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,brasildados/google-ads-api-anuncios-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/0j6ObNPg4ZoNqL7og/builds/iMfsbCW2JWxsme64g/openapi.json