# FlashData Google Search API

Google Search से कार्बनिक परिणाम, संबंधित प्रश्न और समृद्ध परिणाम को संरचित JSON के रूप में पुनर्प्राप्त करें। देश, भाषा और स्थान से फ़िल्टर करें।

कैनोनिकल संदर्भ: https://flashdata.dev/hi/docs/sources/google_search
समीक्षित: 2026-10-23

समापन बिंदु: POST https://data.flashdata.dev/v1/queries/realtime
प्रमाणीकरण: X-API-Key: YOUR_API_KEY
मोड: [Realtime](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/hi/docs/reference/batch-and-bulk/reference.md#batch)

आवश्यक स्रोत अनुमति: google_search

YOUR_API_KEY को API कुंजी के साथ बदलें जिसमें इस स्रोत की अनुमति और उपलब्ध क्रेडिट हैं। अपने सर्वर या एजेंट होस्ट पर अनुरोध चलाएं।

[प्रमाणीकरण सेट करें](https://flashdata.dev/hi/docs/guides/headers-and-authentication/reference.md)

[एक Google खोज को चुनें और परिष्कृत करें](https://flashdata.dev/hi/docs/guides/google-search-guide/reference.md)

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

## एक अनुरोध भेजें

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

## पैरामीटर

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

### अनुरोध का मुख्य भाग

| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | विवरण |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | हाँ | — | google_search को सेट करें।  |
| <a id="parameter-query"></a> query | string | हाँ | सेट नहीं | क्वेरी खोजें। इस तरह के साइट के रूप में Google खोज ऑपरेटरों का समर्थन करता है: और intitle: न्यूनतम लंबाई: 1 अधिकतम लंबाई: 2000 |
| <a id="parameter-params"></a> params | object | नहीं | {} | इस अनुरोध के लिए Settings  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | नहीं | सेट नहीं | केवल Async और बैच। सार्वजनिक HTTPS पूरा होने URL बंदरगाह 443 पर, 2,048 वर्ण तक। कोई उपयोगकर्ता क्रेडेंशियल या URL खंड नहीं। Omit, उपयोग null या कोई अधिसूचना के लिए एक खाली स्ट्रिंग। एक बैच में, इसे प्रत्येक क्वेरी पर सेट करें, बाहर के पैराम।  |

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

### देश, भाषा और स्थान

| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | विवरण |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | नहीं | सेट नहीं | दो-अक्षर देश कोड, जैसे कि हम, जीबी, डी या एसजी। एक देश का चयन करने के लिए स्पष्ट रूप से सेट करें। न्यूनतम लंबाई: 2 अधिकतम लंबाई: 2 पैटर्न: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | नहीं | सेट नहीं | Google इंटरफ़ेस भाषा। एक भाषा का चयन करने के लिए स्पष्ट रूप से सेट करें। न्यूनतम लंबाई: 1 अधिकतम लंबाई: 35 पैटर्न: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | नहीं | सेट नहीं | अनुरोधित खोज स्थान, अधिमानतः एक शहर, जैसे "London, England, United Kingdom"। उपलब्धता खोज प्रकार पर निर्भर करती है। न्यूनतम लंबाई: 1 अधिकतम लंबाई: 200 |

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

### पगिनेशन

| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | विवरण |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | नहीं | सेट नहीं | अनुरोधित परिणाम गिनती। FlashData एक निश्चित डिफ़ॉल्ट नहीं है जब omitted है। वापसी की गिनती क्वेरी और खोज प्रकार से भिन्न हो सकती है। न्यूनतम: 1 अधिकतम: 100 |
| <a id="parameter-params-page"></a> params.page | integer | नहीं | सेट नहीं | अनुरोधित परिणाम पृष्ठ। स्पष्ट रूप से सेट करें। प्रत्येक पृष्ठ एक अलग API अनुरोध है। न्यूनतम: 1 अधिकतम: 100 |

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

### फ़िल्टर खोजें

| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | विवरण |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | नहीं | सेट नहीं | अनुरोधित Google खोज फ़िल्टर, जैसे कि Qdr:d पिछले दिन या qdr: w के लिए पिछले सप्ताह के लिए। उपलब्धता खोज प्रकार पर निर्भर करती है। न्यूनतम लंबाई: 1 अधिकतम लंबाई: 200 |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | नहीं | सेट नहीं | true के साथ वर्तनी सुधार का अनुरोध करें या इसे false के साथ अक्षम करने का अनुरोध करें। एप्लाइड व्यवहार खोज के प्रकार पर निर्भर करता है; Google के व्यवहार का उपयोग करने के लिए मत।  |

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

## परिणाम पढ़ें

सफल JSON प्रतिक्रिया को response.json के रूप में सहेजें। इसे read-response.py के रूप में सहेजें और python read-response.py चलाएं। यह केवल Python के मानक पुस्तकालय का उपयोग करता है और कोई नया अनुरोध नहीं करता है।

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

## उदाहरण जवाब

रिकॉर्ड उदाहरण; फ़ील्ड और गिनती स्रोत पर निर्भर करती है और इनपुट का अनुरोध करती है।
```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"
}
```

## प्रतिक्रिया क्षेत्र

| फील्ड | प्रकार | विवरण |
| --- | --- | --- |
| source | string | अनुरोधित API स्रोत। |
| status | string | जब रियलटाइम अनुरोध सफल होता है तो किया जाता है। |
| created_at | string | ISO 8601 प्रारूप में प्रतिक्रिया निर्माण समय। |
| usage.credits | number | आपकी योजना के आधार पर अनुरोध के लिए शुल्क लिया गया क्रेडिट। |
| results[0].searchParameters | object | खोज सेटिंग्स की रिपोर्ट Google द्वारा की गई है, जिसमें क्वेरी Q के रूप में दर्ज की गई है। रिटर्न सेटिंग्स अनुरोधित मूल्यों से भिन्न हो सकती है। |
| results[0].organic | array | शीर्षक, लिंक, स्निपेट और स्थिति के साथ कार्बनिक परिणाम, साथ ही अतिरिक्त फ़ील्ड उपलब्ध होने पर। |
| results[0].peopleAlsoAsk | array · optional | संबंधित प्रश्न, उत्तर और स्रोत लिंक के साथ उपलब्ध होने पर। |
| results[0].relatedSearches | array · optional | संबंधित खोज की शर्तें, प्रत्येक क्वेरी फ़ील्ड के साथ। |
| results[0].knowledgeGraph | object · optional | ज्ञान पैनल से जीवन की जानकारी। |
| results[0].answerBox | object · optional | विशेष रुप से उत्तर फ़ील्ड उत्तर प्रकार के साथ भिन्न होते हैं। |

- उपलब्ध फ़ील्ड क्वेरी और खोज प्रकार पर निर्भर करती हैं। वैकल्पिक फ़ील्ड अनुपस्थित हो सकते हैं और अतिरिक्त फ़ील्ड वापस आ सकते हैं।
- लौटाने वाले आइटम और searchParameters.num की संख्या params.num से भिन्न हो सकती है। वास्तविक परिणाम गिनती निर्धारित करने के लिए रिटर्न की सरणी का उपयोग करें।

## जवाब के फ़ॉर्मैट

उत्तर डिफ़ॉल्ट रूप से JSON का उपयोग करते हैं। इन वैकल्पिक शीर्षलेखों के साथ एक और प्रारूप चुनें।

- Accept: application/json (डिफ़ॉल्ट) या text/plain. सादा पाठ एक पठनीय, इंडेंट लेआउट में समान फ़ील्ड प्रस्तुत करता है।
- X-Respond-With: markdown. मूल क्षेत्रों के लिए unset छोड़ दें। Markdown या तो प्रतिक्रिया प्रारूप के साथ काम करता है।

Markdown वास्तविक समय के प्रश्नों और पूर्ण परिणाम के लिए उपलब्ध है।

नीचे दिए गए फ़ील्ड डिफ़ॉल्ट JSON प्रतिक्रिया का वर्णन करते हैं।

[अनुरोध और प्रतिक्रिया प्रारूप उदाहरण](https://flashdata.dev/hi/docs/guides/response-formats/reference.md#headers)

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

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

## API की बुनियादी बातें

अनुरोध बिल्डर और उपरोक्त उदाहरण इस स्रोत के पैरामीटर का उपयोग करते हैं। साझा प्रस्तुतीकरण, स्थिति और परिणाम चरणों के लिए नीचे Python और cURL उदाहरणों का उपयोग करें। एक Batch शरीर एक JSON वस्तु है जिसमें क्वेरीज़ शामिल है; प्रत्येक आइटम अपने खुद के काम को लौटा देता है ID.

- [Async अनुरोध और रसीद](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#async)

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

- [नौकरी की स्थिति चेक करें](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#status)

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

- [प्राप्त करने के परिणाम](https://flashdata.dev/hi/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON अनुरोध](https://flashdata.dev/hi/docs/reference/batch-and-bulk/reference.md#batch)
- [ग्राहक OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## पूर्णता अधिसूचना

- [पूरा वेबहुक प्राप्त करना और सत्यापित करना](https://flashdata.dev/hi/docs/guides/async-batch/reference.md#webhooks)

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

## समस्या निवारण

- [त्रुटियाँ और स्टेटस कोड](https://flashdata.dev/hi/docs/errors/reference.md#status-codes)
- [कब्ज़ा](https://flashdata.dev/hi/docs/errors/reference.md#retries)

## संबंधित एपीआई

- [Google Images API](https://flashdata.dev/hi/docs/sources/google_images/reference.md)
- [Google News API](https://flashdata.dev/hi/docs/sources/google_news/reference.md)
