# FlashData Google News API

Abrufen von Google News-Artikeln mit Schlagzeilen, Quellenpublikationen, Links und Veröffentlichungsdaten. Filtern Sie nach Land, Sprache und Datumsbereich.

Kanonische Referenz: https://flashdata.dev/de/docs/sources/google_news
Überarbeitet: 2026-10-23

Endpunkt: POST https://data.flashdata.dev/v1/queries/realtime
Authentifizierung: X-API-Key: YOUR_API_KEY
Modi: [Realtime](https://flashdata.dev/de/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/de/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/de/docs/reference/batch-and-bulk/reference.md#batch)

Erforderliche Berechtigung für die Quelle: google_news

Ersetzen Sie YOUR_API_KEY durch einen API-Schlüssel, der über diese Quellberechtigung und verfügbare Credits verfügt. Führen Sie Anfragen auf Ihrem Server oder Agent-Host aus.

[Authentifizierung einrichten](https://flashdata.dev/de/docs/guides/headers-and-authentication/reference.md)

[Wählen und verfeinern Sie eine Google-Suche](https://flashdata.dev/de/docs/guides/google-search-guide/reference.md)

<a id="quickstart"></a>

## Senden Sie eine Anfrage

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_news",
    "query": "renewable energy",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries/realtime" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "google_news",
  "query": "renewable energy",
  "params": {
    "gl": "us",
    "hl": "en",
    "num": 10,
    "page": 1
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## Parameter

<a id="parameters-group-0"></a>

### Anfrageinhalt

| Parameter | Typ | Erforderlich | Standard | Beschreibung |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ja | — | Setzen Sie auf google_news.  |
| <a id="parameter-query"></a> query | string | Ja | Nicht eingestellt | Suchanfrage. Unterstützt Google Suchoperatoren wie site: und intitle:. Min. Länge: 1. Maximale Länge: 2000. |
| <a id="parameter-params"></a> params | object | Nein | {} | Settings für diese Anfrage.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Nein | Nicht eingestellt | Async und Batch nur. Öffentliche HTTPS Fertigstellung URL auf Port 443, bis zu 2,048 Zeichen. Keine Benutzeranmeldeinformationen oder URL-Fragment. Verwenden Sie null oder einen leeren String für keine Benachrichtigung. Setzen Sie dies in einem Batch auf jede Abfrage, außerhalb von Params.  |

<a id="parameters-group-1"></a>

### Land, Sprache und Standort

| Parameter | Typ | Erforderlich | Standard | Beschreibung |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Nein | Nicht eingestellt | Zwei-Buchstaben-Ländercode, wie uns, gb, de oder sg. Setzen Sie explizit ein Land auswählen. Min. Länge: 2. Maximale Länge: 2. Muster: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Nein | Nicht eingestellt | Google Schnittstellensprache. Setzen Sie explizit eine Sprache auswählen. Min. Länge: 1. Maximale Länge: 35. Muster: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Nein | Nicht eingestellt | Angeforderter Suchort, vorzugsweise eine Stadt, wie "London, England, United Kingdom". Die Verfügbarkeit hängt vom Suchtyp ab. Min. Länge: 1. Maximale Länge: 200. |

<a id="parameters-group-2"></a>

### Pagination

| Parameter | Typ | Erforderlich | Standard | Beschreibung |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Nein | Nicht eingestellt | Angeforderte Ergebniszahl. FlashData fügt keinen festen Standard hinzu, wenn es weggelassen wird. Die zurückgegebene Anzahl kann sich nach Abfrage und Suchtyp unterscheiden. Mindestens: 1. Maximal: 100. |
| <a id="parameter-params-page"></a> params.page | integer | Nein | Nicht eingestellt | Angeforderte Ergebnisseite. Ausdrücklich setzen. Jede Seite ist eine separate API-Anforderung. Mindestens: 1. Maximal: 100. |

<a id="parameters-group-3"></a>

### Suchfilter

| Parameter | Typ | Erforderlich | Standard | Beschreibung |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Nein | Nicht eingestellt | Angeforderte Google-Suchfilter wie qdr:d für den letzten Tag oder qdr:w für die letzte Woche. Die Verfügbarkeit hängt vom Suchtyp ab. Min. Länge: 1. Maximale Länge: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Nein | Nicht eingestellt | Fordern Sie die Rechtschreibkorrektur mit true an oder fordern Sie sie mit false ab. Angewandtes Verhalten hängt vom Suchtyp ab; Verwenden Sie das Verhalten von Google nicht.  |

<a id="response"></a>

## Lesen Sie das Ergebnis

Speichern Sie die erfolgreiche JSON-Antwort als response.json. Speichern Sie dies als read-response.py und führen Sie Python read-response.py aus. Es verwendet nur die Standardbibliothek von Python und stellt keine neue Anforderung.

### read-response.py

```python
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = [
    {"title": item.get("title"), "url": item.get("link"), "publisher": item.get("source"), "date": item.get("date")}
    for item in result.get("news", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## Beispielantwort

Aufgezeichnetes Beispiel; Felder und Zählungen hängen von der Quelle und der angeforderten Eingabe ab.
```json
{
  "source": "google_news",
  "status": "done",
  "results": [
    {
      "searchParameters": {
        "q": "renewable energy",
        "gl": "us",
        "hl": "en",
        "type": "news",
        "num": 10,
        "page": 1,
        "allowSuggested": true,
        "engine": "google"
      },
      "news": [
        {
          "title": "Molder and Hatcher discuss positions on renewable energy, nuclear power ahead of November election",
          "link": "https://tennesseelookout.com/2026/09/14/molder-and-hatcher-discuss-positions-on-renewable-energy-nuclear-power-ahead-of-november-election/",
          "snippet": "District 5 candidates Charlie Hatcher, a Republican farmer and former Tennessee agriculture commissioner, and Chaz Molder, the Democratic...",
          "date": "1 day ago",
          "source": "Tennessee Lookout",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSyHCzprpdTHLlK8zYoWi3-Xyuoj_YpfKHcxb3VhP2GPBH5xvFAhl0fRQA&usqp=CAI&s"
        },
        {
          "title": "Climate Collaborative: Heat pumps key to hitting renewable energy goal",
          "link": "https://www.steamboatpilot.com/news/climate-collaborative-heat-pumps-key-to-hitting-renewable-energy-goal/",
          "snippet": "The Routt County Climate Action Plan Collaborative hosted an open house on Sept. 9 to address various sectors in which it is trying to...",
          "date": "1 day ago",
          "source": "Steamboat Pilot",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRHF-XD_fkuYVqCDDwoZezjCneA7C5ysheQyzjqkRXdormLaLj5qR9jvQo&usqp=CAI&s"
        },
        {
          "title": "Iowa scientists push for more renewable energy to meet growing demands",
          "link": "https://iowacapitaldispatch.com/2026/09/15/iowa-scientists-push-for-more-renewable-energy-to-meet-growing-demands/",
          "snippet": "Iowa scientists have asked Iowans to advocate for the deployment of renewable energy systems to meet growing electricity demand.",
          "date": "12 hours ago",
          "source": "Iowa Capital Dispatch",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQZx80m4v67vKDZTGd1NZ-lTkt-5XQm9WUqp6Up0HShJaH3JuOEsItNjgU&usqp=CAI&s"
        },
        {
          "title": "Juniper Green Energy Commissions New Wind Farms Across India",
          "link": "https://www.powermag.com/juniper-green-energy-commissions-new-wind-farms-across-india/",
          "snippet": "Juniper Green Energy, an independent renewable energy power producer in India, said it has expanded its portfolio with a series of projects...",
          "date": "17 hours ago",
          "source": "POWER Magazine",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQLmOuMsiCedjJNR3jjzRAyDxBay7VUAHaG8UZObtGY9vgnOUayFpuwsrI&usqp=CAI&s"
        },
        {
          "title": "Cameco vs. USA Rare Earth: Which Renewable Energy Stock Is a Better Buy in 2026?",
          "link": "https://www.fool.com/coverage/better-buy/2026/09/15/cameco-vs-usa-rare-earth-which-renewable-energy-stock-is-a-better-buy-in-2026/",
          "snippet": "Cameco generates $775M in free cash flow with a 17% net margin, while USA Rare Earth burns cash as it scales. The valuation gap tells a...",
          "date": "9 hours ago",
          "source": "The Motley Fool",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTYBudJa-unYwDH3DCNtPpTMwB1cdsXPWHjYQW2joDghld74kpOZduLcZA&usqp=CAI&s"
        },
        {
          "title": "China may have a green energy overcapacity problem. Experts think AI can help solve it",
          "link": "https://fortune.com/2026/09/15/china-green-energy-ai/",
          "snippet": "Production in China's clean energy sector has grown so much that there's more energy infrastructure than the market needs.",
          "date": "1 day ago",
          "source": "Fortune",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRW6eTu-3FM7KsoZ5q9f82RxxhcWMa29Tt6Dt8ou4p34tRp2slTyR8T5Ac&usqp=CAI&s"
        },
        {
          "title": "The Energy Transition Is Here: Why Renewable Energy Is One of the Most Compelling Investment Opportunities of Our Time",
          "link": "https://www.morningstar.com/news/accesswire/1220508msn/the-energy-transition-is-here-why-renewable-energy-is-one-of-the-most-compelling-investment-opportunities-of-our-time",
          "snippet": "by Kristin Hull, CEO of Nia Impact Capital. NORTHAMPTON, MA / ACCESS Newswire / September 14, 2026 / There is a moment in every major...",
          "date": "1 day ago",
          "source": "Morningstar",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcROeSoUWZNvlGbcsMzYS5NQsEAXL3zePMGFzIuGwy7NHECmjznDKjdobP0&usqp=CAI&s"
        },
        {
          "title": "India's data center boom creates new engine for renewable energy",
          "link": "https://asia.nikkei.com/business/energy/india-s-data-center-boom-creates-new-engine-for-renewable-energy",
          "snippet": "BENGALURU -- India's push to become a major hub for artificial intelligence is creating a massive opportunity for the country's renewable...",
          "date": "2 days ago",
          "source": "Nikkei Asia",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTtvz9DfrdplKh5Td53Yq079nZkvZFB7xCxLHKhhdnPQtWkUS4KuR3JeQg&usqp=CAI&s"
        },
        {
          "title": "2026 Iowa climate statement calls for renewable energy generation",
          "link": "https://cbs2iowa.com/news/local/gallery/2026-iowa-climate-statement-calls-for-renewable-energy-generation",
          "snippet": "KGAN CBS 2 and KFXA Fox 28 provide local news, weather forecasts, notices of events and items of interest in the community, sports and entertainment...",
          "date": "8 hours ago",
          "source": "KGAN",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTnew7UX8YHNNaVBJcRcH-xbPitO4Z04Q0_5dbp6QvGdkwa42lst11tVEtV&usqp=CAI&s"
        },
        {
          "title": "Energy supply concerns push Europe, Asia toward renewable energy",
          "link": "https://www.dailysabah.com/business/energy/energy-supply-concerns-push-europe-asia-toward-renewable-energy",
          "snippet": "The supply and price shock following the start of the U.S.-Iran war has reshaped energy security policies in Europe and Asia, increasing the...",
          "date": "2 days ago",
          "source": "Daily Sabah",
          "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSULmlmX1DQpYr8tnbQvQO353x2S5Gsyr2YQyK9GHIGXNT9PG_5KeA_04U&usqp=CAI&s"
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  },
  "created_at": "2026-09-16T07:38:04.737Z"
}
```

## Antwortfelder

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| source | string | Die angeforderte API-Quelle. |
| status | string | Dies geschieht, wenn die Echtzeitanforderung erfolgreich ist. |
| created_at | string | Antworterstellungszeit im Format ISO 8601. |
| usage.credits | number | Credits, die für die anfrage berechnet werden, basierend auf ihrem plan. |
| results[0].searchParameters | object | Sucheinstellungen, die von Google gemeldet werden, wobei die Abfrage als q aufgezeichnet wird. Zurückgegebene Einstellungen können von den angeforderten Werten abweichen. |
| results[0].news | array | Suchergebnisse für Nachrichten. |
| results[0].news[].title | string | Artikelüberschrift. |
| results[0].news[].link | string | Artikel URL. |
| results[0].news[].snippet | string · optional | Artikelauszug. |
| results[0].news[].source | string · optional | Bezeichnung der Veröffentlichung. |
| results[0].news[].date | string · optional | Veröffentlichungsdatum wie von Google zurückgegeben; kann relativ sein. |
| results[0].news[].imageUrl | string · optional | Artikel Thumbnail. |
| results[0].news[].position | integer · optional | Ergebnisposition, wenn enthalten. |

- Verfügbare Felder hängen vom Such- und Suchtyp ab. Optionale Felder können fehlen und zusätzliche Felder können zurückgegeben werden.
- Die Anzahl der zurückgegebenen Artikel und searchParameters.num kann von params.num abweichen. Verwenden Sie das zurückgegebene Array, um die tatsächliche Ergebniszahl zu bestimmen.

## Antwortformate

Antworten verwenden standardmäßig JSON. Wählen Sie ein anderes Format mit diesen optionalen Headern.

- Accept: application/json (Ausfall) oder text/plain. Klartext präsentiert die gleichen Felder in einem lesbaren, eingerückten Layout.
- X-Respond-With: markdown. Lassen Sie unset für Originalfelder. Markdown funktioniert mit beiden Antwortformaten.

Markdown steht für Echtzeit-Abfragen und abgeschlossene Ergebnisse zur Verfügung.

Die folgenden Felder beschreiben die Standardantwort von JSON.

[Beispiele für das Anforderungs- und Antwortformat](https://flashdata.dev/de/docs/guides/response-formats/reference.md#headers)

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## API-Grundlagen

Der Request Builder und die obigen Beispiele verwenden die Parameter dieser Quelle. Verwenden Sie die Beispiele Python und cURL unten für gemeinsame Eingabe-, Status- und Ergebnisschritte. Ein Batch-Body ist ein JSON-Objekt, das Abfragen enthält; jedes Element gibt seinen eigenen Job ID zurück.

- [Async Anfrage und Empfang](https://flashdata.dev/de/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [Jobstatus überprüfen](https://flashdata.dev/de/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [Abrufen abgeschlossener Ergebnisse](https://flashdata.dev/de/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON Anfragen](https://flashdata.dev/de/docs/reference/batch-and-bulk/reference.md#batch)
- [Kunden-OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## Abschlussmeldungen

- [Empfangen und Verifizieren von Abschluss-Webhooks](https://flashdata.dev/de/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## Fehlerbehebung

- [Fehler und Statuscodes](https://flashdata.dev/de/docs/errors/reference.md#status-codes)
- [Wann man es erneut versucht](https://flashdata.dev/de/docs/errors/reference.md#retries)

## Verwandte APIs

- [Google Search API](https://flashdata.dev/de/docs/sources/google_search/reference.md)
- [Google Videos API](https://flashdata.dev/de/docs/sources/google_videos/reference.md)
