> ## 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 de Google News

> Obtén los artículos que la pestaña Noticias de Google muestra para una búsqueda, hasta diez páginas, con medio, fecha y enlace.

`GOOGLE_NEWS` devuelve los artículos que Google muestra en su pestaña Noticias para una búsqueda. Lee hasta diez páginas de unos 10 artículos y conserva el orden de Google a través de las páginas, así que puedes seguir qué medios muestra Google para un tema, una marca o un competidor, y cómo cambia con el tiempo.

| | |
| - | - |
| `taskType` | `GOOGLE_NEWS` |
| Entrada | `query` (obligatorio); `pages`, `country`, `device`, `hl` |
| Créditos | 1 por página de Noticias leída. Cada página contiene unos 10 artículos. |
| País | `US` por defecto. Cualquier código ISO 3166-1 alfa-2. |

## Solicitud

Esta solicitud pide las dos primeras páginas de Noticias sobre los aranceles a los vehículos eléctricos en EE. UU.:

```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 } }'
```

La tarea se ejecuta de forma asíncrona. Lee el resultado como se describe en [Tareas asíncronas](https://docs.querying.ai/es/concepts/async-tasks.md).

## Parámetros

| Campo | Obligatorio | Descripción |
| - | - | - |
| `query` | Sí | La búsqueda, de 1 a 100.000 caracteres. Se acepta `prompt` si falta `query`. |
| `pages` | No | Cuántas páginas de Noticias leer, un entero de 1 a 10. `1` por defecto. |
| `country` | No | El mercado de Google en el que buscar. `US` por defecto. El idioma de la página sigue al país salvo que `hl` lo fije. |
| `device` | No | `desktop` por defecto. `mobile` o `android` lee la página que Chrome renderiza en un teléfono Android. `ios` devuelve `422`. |
| `hl` | No | El `hl` de Google, el idioma de la página de noticias. Por defecto, el de `country`. Las fechas y etiquetas de los artículos aparecen en él. `pt-br` se lee como `pt-BR`. |

## Respuesta

Por ejemplo, la solicitud anterior:

```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 | Descripción |
| - | - |
| `newsResults` | Siempre presente, en el orden de Google. Cada artículo tiene `position`, `title`, `link` y `page`, y `snippet`, `source`, `date` y `thumbnail` cuando Google los muestra. |
| `newsResults[].position` | La posición del artículo en toda la lista, desde 1. Continúa a través de las páginas. |
| `newsResults[].page` | La página de Noticias de la que procede, de 1 a 10. |
| `newsResults[].link` | La dirección del artículo. Vacía cuando la redirección de Google no se leyó a tiempo; la redirección está entonces en `redirectLink`. |
| `newsResults[].redirectLink` | La redirección de Google para el artículo, cuando Google sirvió el enlace como una. Resuelve un `link` vacío con [`POST /v1/google/goto`](https://docs.querying.ai/es/api-reference/google-goto). |
| `newsResults[].date` | La antigüedad o la fecha tal como la muestra Google, en el idioma de la página. |
| `pages` | Cuántas páginas de Noticias se leyeron. Se cobran esas páginas. |

Cuando la lista de Google termina antes de `pages`, `newsResults` contiene todos los artículos que Google mostró y `pages` cuenta las páginas leídas. Trata todos los campos salvo `position`, `title`, `link` y `page` como opcionales.

## Créditos

Cada página de Noticias leída cuesta 1 crédito. Al empezar, la tarea retiene los créditos de las páginas que pediste: 1 por defecto, 10 con `pages: 10`. Al completarse se cobran las páginas leídas, así que una lista que Google termina tras tres páginas cuesta 3. Una tarea fallida cuesta 0. Consulta [Créditos y límites](https://docs.querying.ai/es/concepts/credits-and-limits.md).

## Límites y errores

* Un `newsResults` vacío en una tarea completada significa que Google no mostró ningún artículo para la búsqueda. Se confirma en un segundo navegador antes de devolverlo y cuesta 1 crédito.
* Un `hl` que no sea un código de idioma como `en`, `de` o `pt-BR` devuelve `422 VALIDATION_ERROR`.
* Un `pages` fuera de 1-10 o un `device` distinto de `desktop`, `mobile` o `android` devuelve `422 VALIDATION_ERROR`.
* `state` y `uule` devuelven `422 LOCATION_UNSUPPORTED`. Fija el mercado con `country`.
* `include.rawResponse` no tiene efecto, e `include.html` e `include.analysis` devuelven `422`. Consulta [Markdown y respuestas en bruto](https://docs.querying.ai/es/engines/response-options.md).
* Los demás errores de solicitud se enumeran en [Errores](https://docs.querying.ai/es/concepts/errors.md).

## Relacionado

* [Google Search](https://docs.querying.ai/es/engines/google-serp.md) para una página de resultados con sus resultados orgánicos
* [Resolver una redirección de Google](https://docs.querying.ai/es/api-reference/google-goto.md)
* [Créditos y límites](https://docs.querying.ai/es/concepts/credits-and-limits.md)


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