# FlashData Google Search API

Retrievete hasil organik, pertanyaan terkait dan hasil yang kaya dari Google Search sebagai JSON terstruktur. Filter oleh negara, bahasa dan lokasi.

Referensi boonical: https://flashdata.dev/ms/docs/sources/google_search
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_search

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_search",
    "query": "openai",
    "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_search",
  "query": "openai",
  "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_search.  |
| <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"), "snippet": item.get("snippet")}
    for item in result.get("organic", [])
]
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_search",
  "status": "done",
  "results": [
    {
      "searchParameters": {
        "q": "openai",
        "gl": "us",
        "hl": "en",
        "type": "search",
        "num": 10,
        "page": 1,
        "engine": "google"
      },
      "organic": [
        {
          "title": "OpenAI | Research & Deployment",
          "link": "https://openai.com/",
          "snippet": "We believe our research will eventually lead to artificial general intelligence, a system that can solve human-level problems.",
          "position": 1
        },
        {
          "title": "OpenAI",
          "link": "https://en.wikipedia.org/wiki/OpenAI",
          "snippet": "OpenAI is an American artificial intelligence (AI) public benefit corporation (PBC) headquartered in San Francisco. It develops proprietary generative AI models ...",
          "position": 2
        },
        {
          "title": "OpenAI",
          "link": "https://x.com/OpenAI",
          "snippet": "OpenAI's mission is to ensure that artificial general intelligence benefits all of humanity. can develop research, build financial models, and create ...",
          "position": 3
        },
        {
          "title": "OpenAI",
          "link": "https://www.linkedin.com/company/openai",
          "snippet": "OpenAI is an AI research and deployment company dedicated to ensuring that general-purpose artificial intelligence benefits all of humanity.",
          "position": 4
        },
        {
          "title": "r/OpenAI",
          "link": "https://www.reddit.com/r/OpenAI/",
          "snippet": "OpenAI is an AI research and deployment company. OpenAI&#39;s mission is to create safe and powerful AI that benefits all of humanity. OpenAI's ...",
          "position": 5
        }
      ],
      "peopleAlsoAsk": [
        {
          "question": "Is OpenAI created by Elon Musk?"
        },
        {
          "question": "Why are people leaving ChatGPT?"
        },
        {
          "question": "Is OpenAI the same as ChatGPT?"
        },
        {
          "question": "Why is OpenAI in trouble?"
        }
      ],
      "relatedSearches": [
        {
          "query": "OpenAI login"
        },
        {
          "query": "OpenAI chat"
        },
        {
          "query": "OpenAI ChatGPT"
        },
        {
          "query": "OpenAI - wikipedia"
        },
        {
          "query": "OpenAI API"
        },
        {
          "query": "OpenAI app"
        },
        {
          "query": "OpenAI download"
        },
        {
          "query": "OpenAI video"
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  },
  "created_at": "2026-09-16T07:41:40.043Z"
}
```

## 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].organic | array | Hasil organik dengan judul, link, snippet dan posisi, ditambah lagi dengan bidang tambahan bila tersedia. |
| results[0].peopleAlsoAsk | array · optional | Pertanyaan terkait, dengan jawaban dan sumber link sewaktu tersedia. |
| results[0].relatedSearches | array · optional | Istilah pencarian terkait, masing-masing dengan bidang pertanyaan. |
| results[0].knowledgeGraph | object · optional | Informasi entitas dari panel pengetahuan. |
| results[0].answerBox | object · optional | Jawaban yang bagus. Lapangan bervariasi dengan tipe jawaban. |

- 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 Images API](https://flashdata.dev/ms/docs/sources/google_images/reference.md)
- [Google News API](https://flashdata.dev/ms/docs/sources/google_news/reference.md)
