# FlashData Google News API

Ambil artikel Google News dengan berita utama, publikasi sumber, link dan publikasi. Filter oleh negara, bahasa dan jangkauan tanggal.

Referensi kanonikal: https://flashdata.dev/id/docs/sources/google_news
Diulas: 2026-10-23

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

Izin sumber yang diperlukan: google_news

Ganti kunci YOUR_API_KEY dengan kunci API yang memiliki hak sumber ini dan kredit yang tersedia. Jalankan permintaan pada server atau agen host.

[Atur otentikasi](https://flashdata.dev/id/docs/guides/headers-and-authentication/reference.md)

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

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

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

### Isi permintaan

| Parameter | Jenis | Wajib | Default | Deskripsi |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ya | — | Set ke google_news.  |
| <a id="parameter-query"></a> query | string | Ya | Tak ditata | Cari query. Dukungan Google operator pencarian seperti situs: dan tinta:. Panjang Min: 1. Panjang Max: 2000. |
| <a id="parameter-params"></a> params | object | Tidak | {} | Settings untuk permintaan ini.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Tidak | Tak ditata | Async dan batch saja. Publik HTTPS pelengkapan URL di port 443, sampai 2,048 karakter. Tak ada kredensial pengguna atau fragmen URL. Omit, gunakan null atau string kosong untuk tanpa pemberitahuan. Dalam batch, set ini pada setiap query, di luar param.  |

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

### Negara, bahasa & lokasi

| Parameter | Jenis | Wajib | Default | Deskripsi |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Tidak | Tak ditata | Dua huruf kode negara, seperti kita, gb, de atau sg. Set secara eksplisit untuk memilih suatu negara. Panjang Min: 2. Panjang Max: 2. Pola: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Tidak | Tak ditata | Google bahasa antarmuka. Set secara eksplisit untuk memilih suatu bahasa. Panjang Min: 1. Panjang Max: 35. Pola: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Tidak | Tak ditata | Lokasi pencarian yang diminta, sebaiknya sebuah kota, seperti "London, England, United Kingdom". Ketersediaan tergantung pada tipe pencarian. Panjang Min: 1. Panjang Max: 200. |

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

### Paginasi

| Parameter | Jenis | Wajib | Default | Deskripsi |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Tidak | Tak ditata | Jumlah hasil yang diminta. FlashData tidak menambahkan default tetap ketika diabaikan. Jumlah yang kembali dapat berbeda dengan tipe query dan search. Minimum: 1. Maksimum: 100. |
| <a id="parameter-params-page"></a> params.page | integer | Tidak | Tak ditata | Halaman hasil yang diminta. Set secara eksplisit. Setiap halaman adalah permintaan terpisah API. Minimum: 1. Maksimum: 100. |

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

### Saringan pencarian

| Parameter | Jenis | Wajib | Default | Deskripsi |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Tidak | Tak ditata | Diminta Google cari filter, seperti qdr: d untuk hari terakhir atau qdr: w untuk minggu terakhir. Ketersediaan tergantung pada tipe pencarian. Panjang Min: 1. Panjang Max: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Tidak | Tak ditata | Permintaan koreksi ejaan dengan true atau permintaan itu dinonaktifkan dengan false. Perilaku terapan tergantung pada tipe pencarian; omit untuk menggunakan perilaku Google.  |

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

## Baca hasilnya

Simpan respon JSON sukses sebagai response.json. Simpan ini sebagai read-response.py dan jalankan python read-response.py. Ini hanya menggunakan Python perpustakaan standar 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 direkam; ruas dan jumlah 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"
}
```

## Ruas respon

| Ruas | Jenis | Deskripsi |
| --- | --- | --- |
| source | string | Sumber yang diminta API. |
| status | string | dilakukan ketika permintaan realtime sukses. |
| created_at | string | Waktu pembuatan respon dalam format ISO 8601. |
| usage.credits | number | Kredit dikenakan biaya untuk permintaan, berdasarkan rencana Anda. |
| results[0].searchParameters | object | Pengaturan pencarian dilaporkan oleh Google, dengan query direkam sebagai q. Pengaturan ulang mungkin berbeda dari nilai yang diminta. |
| results[0].news | array | Hasil pencarian berita. |
| results[0].news[].title | string | Berita utama artikel. |
| results[0].news[].link | string | Artikel URL. |
| results[0].news[].snippet | string · optional | Pameran artikel. |
| results[0].news[].source | string · optional | Nama penerbitan. |
| results[0].news[].date | string · optional | Tanggal penerbitan sebagai dikembalikan oleh Google; mungkin relatif. |
| results[0].news[].imageUrl | string · optional | Pita jempol artikel. |
| results[0].news[].position | integer · optional | Posisi hasil, bila termasuk. |

- Ruas tersedia bergantung pada tipe query dan search. Bidang opsional mungkin tidak hadir, dan bidang tambahan mungkin dikembalikan.
- Jumlah item yang dikembalikan dan searchParameters.num dapat berbeda dari params.num. Gunakan array yang dikembalikan untuk menentukan jumlah hasil yang sebenarnya.

## Format respons

Respon menggunakan JSON secara baku. Pilih format lain dengan header opsional ini.

- Accept: application/json (baku) atau text/plain. Teks biasa menyajikan ruas yang sama dalam tata letak yang dapat dibaca, tidak terbaca.
- X-Respond-With: markdown. Tinggalkan unset untuk bidang asli. Markdown bekerja dengan baik format respon.

Markdown tersedia untuk kueri realtime dan hasil selesai.

Bidang di bawah ini menjelaskan respon baku JSON.

[Permohonan dan contoh format respon](https://flashdata.dev/id/docs/guides/response-formats/reference.md#headers)

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

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

## Dasar-dasar API

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

- [Async permintaan dan tanda terima](https://flashdata.dev/id/docs/reference/realtime-and-async/reference.md#async)

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

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

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

- [Mengambil hasil selesai](https://flashdata.dev/id/docs/reference/realtime-and-async/reference.md#results)
- [permintaan Batch JSON](https://flashdata.dev/id/docs/reference/batch-and-bulk/reference.md#batch)
- [Pelanggan OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Pemberitahuan penyelesaian

- [Menerima dan memverifikasi pelengkapan webhooks](https://flashdata.dev/id/docs/guides/async-batch/reference.md#webhooks)

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

## Permasalahan menarik

- [Kesalahan dan kode status](https://flashdata.dev/id/docs/errors/reference.md#status-codes)
- [Kapan untuk mencoba lagi](https://flashdata.dev/id/docs/errors/reference.md#retries)

## Terkait APIs

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