# FlashData Google News API

Artikel Berita Google dengan tajuk utama, publikasi sumber, tautan dan tanggal publikasi. Filter oleh negara, bahasa dan rentang tanggal.

Referensi boonical: https://flashdata.dev/ms/docs/sources/google_news
Diulas: 2026-10-23

Titik akhir Ukur: POST https://data.flashdata.dev/v1/queries/realtime
Pengesahan: X-API-Key: YOUR_API_KEY
Mode: [Realtime](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/ms/docs/reference/batch-and-bulk/reference.md#batch)

Izin sumber yang dibutuhkan: google_news

Megantikan YOUR_API_KEY dengan kunci API yang memiliki izin sumber ini dan kredit yang tersedia. Permintaan run run pada server atau agen host anda.

[Otentikasi Gagal](https://flashdata.dev/ms/docs/guides/headers-and-authentication/reference.md)

[Pilih dan perbaiki pencarian Google](https://flashdata.dev/ms/docs/guides/google-search-guide/reference.md)

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

## Upn permintaan

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

### Badan permintaan

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ya | — | Ditetapkan untuk google_news.  |
| <a id="parameter-query"></a> query | string | Ya | Tidak Diset | Pertanyaan pencarian. Sogodis Supports Google operator pencarian seperti situs: dan judul:. Panjang Min: 1. Panjang maksimum: 2000. |
| <a id="parameter-params"></a> params | object | Tak ada | {} | Settings untuk permintaan ini.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Tak ada | Tidak Diset | Async dan hanya kelumpuhan. Kompisi HTTPS publik URL pada port 443, hingga karakter 2,048. Kelayakan pengguna tidak ada atau fragmen URL. Omit, gunakan null atau string kosong tanpa pemberitahuan. Dalam kelompok, set ini pada setiap pertanyaan, param luar.  |

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

### Kampung, bahasa & lokasi

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Tak ada | Tidak Diset | Kode negara dua huruf, seperti kita, gb, de atau sg. Diatur secara eksplisit untuk memilih sebuah negara. Panjang Min: 2. Panjang maksimum: 2. Corak: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Tak ada | Tidak Diset | Google Bahasa antarmuka jaringan. [ Gambar di hlm. Panjang Min: 1. Panjang maksimum: 35. Corak: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Tak ada | Tidak Diset | Yang diminta untuk mencari lokasi, lebih baik sebuah kota, seperti "London, England, United Kingdom". Ketersediaan tergantung pada jenis pencarian. Panjang Min: 1. Panjang maksimum: 200. |

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

### Kepinaran

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Tak ada | Tidak Diset | Hasil yang diminta dihitung. FlashData tidak menambahkan default tetap ketika diabaikan. Angka yang dikembalikan dapat berbeda menurut pertanyaan dan jenis pencarian. Minimal: 1. Maximum: 100. |
| <a id="parameter-params-page"></a> params.page | integer | Tak ada | Tidak Diset | Halaman hasil yang dimintakan untuk diminta. Set secara eksplisit. Setiap halaman adalah permintaan API yang terpisah. Minimal: 1. Maximum: 100. |

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

### penapis pencarian fanfan

| Parameter | Jenis | Wajib | Lalai | Keterangan |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Tak ada | Tidak Diset | FANFA yang diminta filter pencarian Google, seperti qdr:d untuk hari terakhir atau qdr:w untuk minggu terakhir. Ketersediaan tergantung pada jenis pencarian. Panjang Min: 1. Panjang maksimum: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Tak ada | Tidak Diset | Permintaan koreksi ejaan dengan trueQ atau meminta dinon-aktifkan dengan false. Perilaku yang diterapkan berdasarkan tipe pencarian; mengabaikan untuk menggunakan perilaku Google.  |

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

## Baca hasilnya

Simpan respon JSON yang sukses sebagai response.json. Simpan ini sebagai read-response.py dan jalankan python read-response.py. Ini hanya menggunakan perpustakaan standar Python dan tidak membuat permintaan baru.

### 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))
```

## Contoh respons

Contoh terrekam; bidang dan hitungan bergantung pada sumber dan masukan yang diminta.
```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"
}
```

## Medan tanggapan palsu

| Ukrainian | Jenis | Keterangan |
| --- | --- | --- |
| source | string | Sumber API yang diminta. |
| status | string | Hal ini dilakukan ketika permintaan realtime berhasil. |
| created_at | string | Waktu penciptaan responsi kreasi dalam format ISO 8601. |
| usage.credits | number | Penghargaan atas permintaan itu, berdasarkan rencanamu. |
| results[0].searchParameters | object | Pengaturan pencarian visier dilaporkan oleh Google, dengan pertanyaan yang dicatat sebagai q. Pengaturan yang dikembalikan dapat berbeda dengan nilai yang diminta. |
| results[0].news | array | Hasil pencarian berita. |
| results[0].news[].title | string | Artikel utama. |
| results[0].news[].link | string | Artikel URL. |
| results[0].news[].snippet | string · optional | Penjelasan Artikel Kelengkapan. |
| results[0].news[].source | string · optional | Nama publikasi. |
| results[0].news[].date | string · optional | Tanggal penerbitan seperti yang dikembalikan oleh Google; mungkin relatif. |
| results[0].news[].imageUrl | string · optional | Artikel thumbnail. |
| results[0].news[].position | integer · optional | Posisi hasil, bila disertakan. |

- Bidang-bidang yang tersedia tergantung pada jenis pertanyaan dan pencarian. Medan opsional mungkin tidak ada, dan ladang tambahan mungkin dikembalikan.
- Jumlah barang yang dikembalikan dan searchParameters.num dapat berbeda dengan params.num. Anda menggunakan susunan yang dikembalikan untuk menentukan jumlah hasil yang sebenarnya.

## Format respons

Sambutan menggunakan JSON secara default. Memikul format lain dengan header opsional ini.

- Accept: application/json (default) OR atau ORANG text/plain. Teks Plain menyajikan bidang yang sama dalam tata letak yang dapat dibaca dan diindentasi.
- X-Respond-With: markdown. Jangan sampai tidak sesuai dengan bidang asli. Markdown bekerja dengan baik format respon.

Markdown tersedia untuk pertanyaan waktu nyata dan hasil selesai.

Bidang-bidang di bawah ini menggambarkan respon JSON baku.

[Contoh format permintaan dan tanggapan](https://flashdata.dev/ms/docs/guides/response-formats/reference.md#headers)

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

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

## Asas API

Waaswan permintaan pembangun dan contoh di atas menggunakan parameter sumber ini. Andaikata menggunakan contoh Python dan cURL di bawah ini untuk penyerahan bersama, status dan langkah hasil. Tubuh Batch adalah sebuah objek JSON yang berisi kueri; setiap item mengembalikan pekerjaannya sendiri ID.

- [Permintaan dan penerimaan Async](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#async)

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

- [Periksa status pekerjaan](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#status)

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

- [Hasil yang telah selesai](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#results)
- [Permintaan Batch JSON](https://flashdata.dev/ms/docs/reference/batch-and-bulk/reference.md#batch)
- [BukaAPI Pelanggan oleh:](https://flashdata.dev/docs/openapi.json)

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

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

## Pemberitahuan penyelesaian hasil Pengundian

- [Terima dan sahkan pelengkapan webhooks](https://flashdata.dev/ms/docs/guides/async-batch/reference.md#webhooks)

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

## Penerjemahan Masalah

- [Ralat dan kod status](https://flashdata.dev/ms/docs/errors/reference.md#status-codes)
- [Bila hendak mencoba lagi](https://flashdata.dev/ms/docs/errors/reference.md#retries)

## API yang berkaitan dengan anak - anak

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