> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API de resultados do Google News

> Receba os artigos que a aba Notícias do Google lista para uma busca, até dez páginas, com veículo, data e link.

`GOOGLE_NEWS` retorna os artigos que o Google lista na aba Notícias para uma busca. Ele lê até dez páginas de cerca de 10 artigos e mantém a ordem do Google através das páginas, então você acompanha quais veículos o Google mostra para um tema, uma marca ou um concorrente, e como isso muda ao longo do tempo.

| | |
| - | - |
| `taskType` | `GOOGLE_NEWS` |
| Entrada | `query` (obrigatório); `pages`, `country`, `device`, `hl` |
| Créditos | 1 por página de Notícias lida. Cada página tem cerca de 10 artigos. |
| País | Padrão `US`. Qualquer código ISO 3166-1 alfa-2. |

## Requisição

Esta requisição pede as duas primeiras páginas de Notícias sobre tarifas de veículos elétricos nos EUA:

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE_NEWS", "payload": { "query": "electric vehicle tariffs", "country": "US", "pages": 2 } }'
```

A tarefa roda de forma assíncrona. Leia o resultado como descrito em [Tarefas assíncronas](https://docs.querying.ai/pt/concepts/async-tasks.md).

## Parâmetros

| Campo | Obrigatório | Descrição |
| - | - | - |
| `query` | Sim | A busca, de 1 a 100.000 caracteres. `prompt` é aceito quando `query` está ausente. |
| `pages` | Não | Quantas páginas de Notícias ler, um inteiro de 1 a 10. Padrão `1`. |
| `country` | Não | O mercado do Google a buscar. Padrão `US`. O idioma da página segue o país, a menos que `hl` o defina. |
| `device` | Não | `desktop` por padrão. `mobile` ou `android` lê a página que o Chrome renderiza em um celular Android. `ios` retorna `422`. |
| `hl` | Não | O `hl` do Google, o idioma da página de notícias. O padrão é o idioma de `country`. As datas e os rótulos das notícias aparecem nele. `pt-br` é lido como `pt-BR`. |

## Resposta

Por exemplo, a requisição acima:

```json theme={"theme":"css-variables"}
{
  "newsResults": [
    {
      "position": 1,
      "title": "...",
      "link": "https://...",
      "snippet": "...",
      "source": "...",
      "date": "3 hours ago",
      "page": 1,
      "thumbnail": "..."
    },
    { "position": 11, "page": 2, "...": "..." }
  ],
  "pages": 2
}
```

| Campo | Descrição |
| - | - |
| `newsResults` | Sempre presente, na ordem do Google. Cada artigo traz `position`, `title`, `link` e `page`, e `snippet`, `source`, `date` e `thumbnail` quando o Google os mostra. |
| `newsResults[].position` | A posição do artigo na lista inteira, a partir de 1. Continua através das páginas. |
| `newsResults[].page` | A página de Notícias de onde o artigo veio, de 1 a 10. |
| `newsResults[].link` | O endereço do artigo. Vazio quando o redirecionamento do Google não foi lido a tempo; o redirecionamento fica então em `redirectLink`. |
| `newsResults[].redirectLink` | O redirecionamento do Google para o artigo, quando o Google serviu o link dessa forma. Resolva um `link` vazio com [`POST /v1/google/goto`](https://docs.querying.ai/pt/api-reference/google-goto). |
| `newsResults[].date` | A idade ou a data como o Google a mostra, no idioma da página. |
| `pages` | Quantas páginas de Notícias foram lidas. A tarefa é cobrada por elas. |

Quando a lista do Google termina antes de `pages`, `newsResults` traz todos os artigos que o Google listou e `pages` conta as páginas lidas. Trate todo campo, exceto `position`, `title`, `link` e `page`, como opcional.

## Créditos

Cada página de Notícias lida custa 1 crédito. Quando começa, a tarefa reserva os créditos das páginas pedidas: 1 no padrão, 10 com `pages: 10`. Na conclusão, ela é cobrada pelas páginas lidas, então uma lista que o Google encerra após três páginas custa 3. Uma tarefa com falha custa 0. Veja [Créditos e limites](https://docs.querying.ai/pt/concepts/credits-and-limits.md).

## Limites e erros

* Um `newsResults` vazio em uma tarefa concluída significa que o Google não listou nenhum artigo para a busca. Isso é confirmado em um segundo navegador antes de ser retornado e custa 1 crédito.
* Um `hl` que não seja um código de idioma como `en`, `de` ou `pt-BR` retorna `422 VALIDATION_ERROR`.
* `pages` fora de 1-10 ou um `device` diferente de `desktop`, `mobile` ou `android` retorna `422 VALIDATION_ERROR`.
* `state` e `uule` retornam `422 LOCATION_UNSUPPORTED`. Defina o mercado com `country`.
* `include.rawResponse` não tem efeito, e `include.html` e `include.analysis` retornam `422`. Veja [Markdown e respostas brutas](https://docs.querying.ai/pt/engines/response-options.md).
* Os demais erros de requisição estão em [Erros](https://docs.querying.ai/pt/concepts/errors.md).

## Relacionados

* [Google Search](https://docs.querying.ai/pt/engines/google-serp.md) para uma página de resultados com seus resultados orgânicos
* [Resolver um redirecionamento do Google](https://docs.querying.ai/pt/api-reference/google-goto.md)
* [Créditos e limites](https://docs.querying.ai/pt/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.