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

# Google-News-Ergebnisse per API

> Die Artikel abrufen, die Googles News-Tab zu einer Suche listet, bis zu zehn Seiten, mit Medium, Datum und Link.

`GOOGLE_NEWS` liefert die Artikel, die Google im Tab „News“ zu einer Suche listet. Es liest bis zu zehn Seiten mit je etwa 10 Artikeln und behält Googles Reihenfolge über die Seiten hinweg bei. So verfolgen Sie, welche Medien Google zu einem Thema, einer Marke oder einem Wettbewerber zeigt und wie sich das über die Zeit ändert.

| | |
| - | - |
| `taskType` | `GOOGLE_NEWS` |
| Eingabe | `query` (Pflicht); `pages`, `country`, `device`, `hl` |
| Credits | 1 pro gelesener News-Seite. Eine Seite enthält etwa 10 Artikel. |
| Land | Standard ist `US`. Jeder ISO-3166-1-Alpha-2-Code. |

## Anfrage

Diese Anfrage ruft die ersten zwei News-Seiten zu Zöllen auf Elektrofahrzeuge in den USA ab:

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

Der Task läuft asynchron. Lesen Sie das Ergebnis wie unter [Asynchrone Tasks](https://docs.querying.ai/de/concepts/async-tasks.md) beschrieben.

## Parameter

| Feld | Pflicht | Beschreibung |
| - | - | - |
| `query` | Ja | Die Suche, 1-100.000 Zeichen. `prompt` wird akzeptiert, wenn `query` fehlt. |
| `pages` | Nein | Wie viele News-Seiten gelesen werden, eine ganze Zahl von 1 bis 10. Standard ist `1`. |
| `country` | Nein | Der Google-Markt, in dem gesucht wird. Standard ist `US`. Die Sprache der Seite folgt dem Land, sofern `hl` sie nicht setzt. |
| `device` | Nein | Standard ist `desktop`. `mobile` oder `android` liest die Seite, die Chrome auf einem Android-Telefon rendert. `ios` liefert `422`. |
| `hl` | Nein | Googles `hl`, die Sprache der News-Seite. Standard ist die Sprache des `country`. Datumsangaben und Beschriftungen erscheinen darin. `pt-br` wird als `pt-BR` gelesen. |

## Antwort

Zum Beispiel die Anfrage oben:

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

| Feld | Beschreibung |
| - | - |
| `newsResults` | Immer vorhanden, in Googles Reihenfolge. Jeder Artikel hat `position`, `title`, `link` und `page` sowie `snippet`, `source`, `date` und `thumbnail`, wenn Google sie zeigt. |
| `newsResults[].position` | Der Rang des Artikels in der gesamten Liste, ab 1. Er zählt über Seiten hinweg weiter. |
| `newsResults[].page` | Die News-Seite, von der der Artikel stammt, 1 bis 10. |
| `newsResults[].link` | Die Adresse des Artikels. Leer, wenn Googles Weiterleitung nicht rechtzeitig gelesen wurde; die Weiterleitung steht dann in `redirectLink`. |
| `newsResults[].redirectLink` | Googles Weiterleitung für den Artikel, wenn Google den Link als solche ausgeliefert hat. Lösen Sie einen leeren `link` mit [`POST /v1/google/goto`](https://docs.querying.ai/de/api-reference/google-goto) auf. |
| `newsResults[].date` | Alter oder Datum, wie Google es anzeigt, in der Sprache der Seite. |
| `pages` | Wie viele News-Seiten gelesen wurden. Diese werden berechnet. |

Endet Googles Liste vor `pages`, enthält `newsResults` alle Artikel, die Google gelistet hat, und `pages` zählt die gelesenen Seiten. Behandeln Sie jedes Feld außer `position`, `title`, `link` und `page` als optional.

## Credits

Jede gelesene News-Seite kostet 1 Credit. Beim Start reserviert der Task die Credits für die angefragten Seiten: 1 beim Standard, 10 bei `pages: 10`. Bei Abschluss werden die gelesenen Seiten berechnet, eine Liste, die Google nach drei Seiten beendet, kostet also 3. Ein fehlgeschlagener Task kostet 0. Siehe [Credits und Limits](https://docs.querying.ai/de/concepts/credits-and-limits.md).

## Grenzen und Fehler

* Ein leeres `newsResults` in einem abgeschlossenen Task bedeutet, dass Google für die Suche keine Artikel gelistet hat. Das wird vor der Rückgabe in einem zweiten Browser bestätigt und kostet 1 Credit.
* Ein `hl`, das kein Sprachcode wie `en`, `de` oder `pt-BR` ist, liefert `422 VALIDATION_ERROR`.
* `pages` außerhalb von 1-10 oder ein `device` außer `desktop`, `mobile` und `android` liefert `422 VALIDATION_ERROR`.
* `state` und `uule` liefern `422 LOCATION_UNSUPPORTED`. Legen Sie den Markt mit `country` fest.
* `include.rawResponse` hat keine Wirkung, `include.html` und `include.analysis` liefern `422`. Siehe [Markdown und Rohantworten](https://docs.querying.ai/de/engines/response-options.md).
* Weitere Anfragefehler stehen unter [Fehler](https://docs.querying.ai/de/concepts/errors.md).

## Verwandt

* [Google Search](https://docs.querying.ai/de/engines/google-serp.md) für eine Ergebnisseite mit ihren organischen Ergebnissen
* [Google-Weiterleitung auflösen](https://docs.querying.ai/de/api-reference/google-goto.md)
* [Credits und Limits](https://docs.querying.ai/de/concepts/credits-and-limits.md)


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