# Google News Scraper Brasil API - Monitor de Notícias e Marcas (`brasildados/google-news-scraper-brasil-api`) Actor

Monitore notícias, marcas, empresas e temas no Google News com buscas em português e foco no Brasil. Informe uma ou várias consultas e exporte título, fonte, autores, link, domínio, imagens e data de publicação em JSON, CSV ou Excel para clipping, reputação, pesquisa de mercado e alertas.

- **URL**: https://apify.com/brasildados/google-news-scraper-brasil-api.md
- **Developed by:** [BrasilDados.org](https://apify.com/brasildados) (community)
- **Categories:** Lead generation, News, Other
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $500.00 / 1,000 por notícia retornadas

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

### Google News Scraper Brasil API para monitorar notícias, marcas e temas

Transforme consultas do Google News em dados organizados para clipping, monitoramento de marca, reputação, pesquisa de mercado e acompanhamento de concorrentes. Informe uma ou várias consultas e receba uma linha por notícia com título, veículo, autores, link normalizado, domínio, imagens e data de publicação.

O Actor pesquisa em português, com foco no Brasil, e permite limitar o período às últimas 24 horas, 7 dias, 30 dias ou qualquer data disponível. Os resultados podem ser usados na Apify, exportados em JSON, CSV ou Excel e consumidos diretamente por HTTP.

### O que você pode fazer

- Monitorar menções a marcas, empresas, produtos e executivos.
- Montar clipping de notícias para clientes ou equipes internas.
- Acompanhar setores, tecnologias, regulamentações e concorrentes.
- Alimentar dashboards, alertas e automações com dados estruturados.
- Usar operadores como `"nome exato"`, `site:dominio.com.br` e termos negativos.

### Como usar

1. Adicione suas buscas em **Consultas**. Para uma única busca, mantenha uma lista com um item.
2. Escolha o período das notícias.
3. Defina o máximo de notícias por consulta.
4. Inicie a execução e abra a aba **Dataset** para visualizar ou exportar os resultados.

Exemplo de entrada:

```json
{
  "queries": ["inteligência artificial Brasil", "energia solar"],
  "period": "7d",
  "maxResultsPerQuery": 20
}
```

### Dados entregues

| Campo | Descrição |
| --- | --- |
| `resultPosition` | Posição sequencial da notícia na saída. |
| `queryPosition` | Posição dentro da consulta após ordenar da mais recente para a mais antiga. |
| `sourcePosition` | Posição original informada pela pesquisa, quando disponível. |
| `title` | Título público da notícia. |
| `sourceName` | Nome do veículo, quando disponível. |
| `sourceIconUrl` | Ícone público do veículo, quando disponível. |
| `authors` | Lista de autores informados. |
| `articleUrl` | Link público da notícia. |
| `articleDomain` | Domínio extraído do link. |
| `thumbnailUrl` | Imagem de destaque, quando disponível. |
| `smallThumbnailUrl` | Miniatura reduzida, quando disponível. |
| `hasImage` | Indica se alguma imagem foi encontrada. |
| `publishedAt` | Data de publicação em ISO 8601, quando disponível. |
| `publishedDate` | Data de publicação no formato `AAAA-MM-DD`. |
| `publishedAtText` | Data relativa ou textual exibida na notícia. |
| `ageHours` | Idade aproximada da notícia em horas no momento da coleta. |
| `query` | Consulta responsável pelo resultado. |
| `period` | Período solicitado. |
| `language` | Idioma configurado: `pt-BR`. |
| `country` | País configurado: `Brasil`. |
| `collectedAt` | Data e hora da coleta em ISO 8601. |

Exemplo completo de resultado:

```json
{
  "resultPosition": 1,
  "queryPosition": 1,
  "sourcePosition": 3,
  "title": "Empresas brasileiras ampliam projetos de inteligência artificial",
  "sourceName": "Exemplo Notícias",
  "sourceIconUrl": "https://example.com/icon.png",
  "authors": ["Ana Silva"],
  "articleUrl": "https://example.com/tecnologia/projetos-inteligencia-artificial",
  "articleDomain": "example.com",
  "thumbnailUrl": "https://example.com/imagens/noticia.jpg",
  "smallThumbnailUrl": "https://example.com/imagens/noticia-80x80.jpg",
  "hasImage": true,
  "publishedAt": "2026-08-13T12:00:00.000Z",
  "publishedDate": "2026-08-13",
  "publishedAtText": "há 6 horas",
  "ageHours": 6,
  "query": "inteligência artificial Brasil",
  "period": "7d",
  "language": "pt-BR",
  "country": "Brasil",
  "collectedAt": "2026-08-13T18:00:00.000Z"
}
```

### Executar em Batch ou Standby

Use **Batch** para buscas maiores, agendamentos, integrações recorrentes e exportação pelo Dataset. Use **Standby** quando sua aplicação precisar receber os resultados diretamente por HTTP.

#### Batch

```bash
curl -X POST "https://api.apify.com/v2/acts/brasildados~google-news-scraper-brasil-api/runs?token=SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["inteligência artificial Brasil","energia solar"],"period":"7d","maxResultsPerQuery":20}'
```

Cada notícia é gravada como uma linha no Dataset padrão, pronta para exportação.

#### Standby

```bash
curl -X POST "URL_STANDBY/search" \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["inteligência artificial Brasil","energia solar"],"period":"7d","maxResultsPerQuery":20}'
```

O Standby retorna diretamente um array JSON com o mesmo formato das linhas do Dataset.

### Preço

A cobrança é por notícia entregue no evento `result-item`. Notícias duplicadas, registros inválidos e buscas sem resultados não são cobrados. O custo estimado é a quantidade máxima de consultas multiplicada por `maxResultsPerQuery`, limitada pelos resultados realmente encontrados e pelo limite de gasto configurado na Apify.

### Limitações

- A cobertura e a ordem por relevância dependem das notícias disponíveis no momento da consulta.
- Nem todas as fontes informam autores, imagens ou uma data ISO; nesses casos, os campos opcionais retornam `null` ou lista vazia.
- O Actor não abre nem extrai o conteúdo integral das páginas encontradas.
- O filtro de período usa a data reconhecida pela pesquisa e não garante um arquivo histórico completo.
- Links recebem tratamento para remover parâmetros comuns de rastreamento, e a mesma notícia encontrada por mais de uma consulta é entregue uma única vez por execução.

### Perguntas frequentes

#### Posso buscar uma expressão exata?

Sim. Use aspas, por exemplo `"Banco Exemplo"`, dentro de uma consulta.

#### Posso monitorar somente um veículo?

Sim. Acrescente o operador `site:`, como `energia solar site:exemplo.com.br`.

#### Quantas consultas posso enviar?

Até 10 consultas por execução. Cada consulta pode solicitar de 1 a 100 notícias, respeitando a disponibilidade da pesquisa e o limite de gasto da execução.

#### Preciso fornecer uma chave externa?

Não. Para usar o Actor pela API, você fornece somente o token da sua própria conta Apify.

### Suporte

Se encontrar um resultado incompatível com este README, envie o input utilizado, o ID da execução e uma descrição do comportamento pela aba **Issues** do Actor. Não inclua tokens ou outras credenciais.

# Actor input Schema

## `queries` (type: `array`):

Marcas, empresas, pessoas ou temas que deseja monitorar. Aceita operadores de busca como aspas e site:.

## `period` (type: `string`):

Filtra as notícias pela data de publicação.

## `maxResultsPerQuery` (type: `integer`):

Limite de notícias entregues e cobradas para cada consulta.

## Actor input object example

```json
{
  "queries": [
    "inteligência artificial Brasil",
    "energia solar"
  ],
  "period": "7d",
  "maxResultsPerQuery": 20
}
```

# Actor output Schema

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

Dataset com uma linha por notícia encontrada.

# 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-news-scraper-brasil-api").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-news-scraper-brasil-api").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-news-scraper-brasil-api --silent --output-dataset

```

## MCP server setup

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

```

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/r8qe9YfMPlnA9hYlf/builds/sB0rkr3Yh3NIdzgwr/openapi.json