# FlashData Google Search API

Organik sonuçlar, Google Search ile ilgili sorular ve zengin sonuçlar yapısal JSON olarak yapılandırıldı. Ülkeye, dile ve yere filtreleyin.

Canonical referans: https://flashdata.dev/tr/docs/sources/google_search
İnceleme: 2026-10-23

Endpoint: POST https://data.flashdata.dev/v1/queries/realtime
Kimlik doğrulama: X-API-Key: YOUR_API_KEY
Modes Modes: [Realtime](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md#batch)

Gerekli kaynak izni izni: google_search

Değişimi Değiştir YOUR_API_KEY Biriyle birlikte API Bu kaynak izni ve mevcut kredilere sahip anahtar. sunucunuzda veya acente ev sahibinizde yükleme talepleri.

[Varsayılan kimlik doğrulamayı ayarlayın](https://flashdata.dev/tr/docs/guides/headers-and-authentication/reference.md)

[Bir Google aramasını seçin ve geliştirin](https://flashdata.dev/tr/docs/guides/google-search-guide/reference.md)

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

## Bir istek gönder

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

## Parametreler

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

### İstek gövdesi

| Parametre parametresi | Tür Türü Tipi | Zorunlu | Varsayılan | Description Description Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Evet Evet Evet | — | google_search'a ayarlayın.  |
| <a id="parameter-query"></a> query | string | Evet Evet Evet | Set Not set Not set | Arama sorgusu. Google arama operatörleri site gibi: ve intitle:. Min uzunluğu: 1. Max uzunluğu: 2000. |
| <a id="parameter-params"></a> params | object | Hayır yok hayır | {} | Settings bu istek için.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Hayır yok hayır | Set Not set Not set | Async ve sadece toplu. Halk Halk Halkı HTTPS Tamam tamamlanma tamamlanma tamamlanma tamamlandı URL limanda 443, yukarı 2,048 karakterler. Kullanıcı Bilgileri veya URL parçaları yok. Omit, null veya bildirim için boş bir dize kullanın. Bir partide, bunu her sorguda, params dışında ayarlayın.  |

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

### Ülke, dil & yer

| Parametre parametresi | Tür Türü Tipi | Zorunlu | Varsayılan | Description Description Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Hayır yok hayır | Set Not set Not set | Bizim gibi, gb, de ya da sg gibi iki harfli ülke kodu. Bir ülkeyi seçmek için açıkça ayarlayın. Min uzunluğu: 2. Max uzunluğu: 2. Desen: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Hayır yok hayır | Set Not set Not set | Google arayüzü dili. Bir dili seçmek için açıkça ayarlayın. Min uzunluğu: 1. Max uzunluğu: 35. Desen: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Hayır yok hayır | Set Not set Not set | Talep edilen arama yeri, tercihen bir şehir, "London, England, United Kingdom" gibi. Erişilebilirlik arama türüne bağlıdır. Min uzunluğu: 1. Max uzunluğu: 200. |

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

### Pagination

| Parametre parametresi | Tür Türü Tipi | Zorunlu | Varsayılan | Description Description Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Hayır yok hayır | Set Not set Not set | İstekli sonuç sayımı. FlashData, ihmal edildiğinde sabit bir varsayılan eklemez. Geri sayı sorgu ve arama türü ile farklı olabilir. Asgari: 1. Maksimum: 100. |
| <a id="parameter-params-page"></a> params.page | integer | Hayır yok hayır | Set Not set Not set | İstekli sonuç sayfası. Açıkça ayarlayın. Her sayfa ayrı bir API isteğidir. Asgari: 1. Maksimum: 100. |

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

### Arama filtreleri

| Parametre parametresi | Tür Türü Tipi | Zorunlu | Varsayılan | Description Description Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Hayır yok hayır | Set Not set Not set | Google arama filtreleri, qdr gibi: geçen gün veya qdr için: geçen hafta için. Erişilebilirlik arama türüne bağlıdır. Min uzunluğu: 1. Max uzunluğu: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Hayır yok hayır | Set Not set Not set | true ile düzeltme talep etmek veya false ile devre dışı bırakmak. Uygulamalı davranış arama türüne bağlıdır; Google’nun davranışını kullanmak için omit.  |

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

## Sonuç okuyun

JSON yanıtını response.json olarak kurtarın. Bunu read-response.py olarak kaydedin ve python read-response.py çalıştırın. Sadece Python'un standart kütüphanesini kullanır ve yeni bir istek yapmaz.

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

## Örnek yanıt

Kayıt örneği; alanlar ve sayılar kaynağına bağlıdır ve talep edilen girdiye bağlıdır.
```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"
}
```

## Yanıt alanları

| Field | Tür Türü Tipi | Description Description Description |
| --- | --- | --- |
| source | string | Talep edilen API kaynağı. |
| status | string | Gerçek zamanlı istek başarılı olduğunda yapılır. |
| created_at | string | ISO 8601 formatındaki arama süresi. |
| usage.credits | number | Krediler talep için ücretlendirilir, planınıza göre. |
| results[0].searchParameters | object | Google tarafından bildirilen arama ayarları, q olarak kaydedilen sorgu ile. Geri dönen ayarlar talep edilen değerlerden farklı olabilir. |
| results[0].organic | array | Başlık, bağlantı, parçaları ve pozisyonu ile organik sonuçlar, mevcut olduğunda ek alanlar. |
| results[0].peopleAlsoAsk | array · optional | İlgili sorular, mevcut olduğunda cevaplar ve kaynak bağlantıları ile. |
| results[0].relatedSearches | array · optional | İlgili arama terimleri, her biri bir sorgu alanı ile. |
| results[0].knowledgeGraph | object · optional | Bilgi panelinden gelen bilgi. |
| results[0].answerBox | object · optional | Özel cevap. Alanlar cevap türü ile değişir. |

- Mevcut alanlar sorguya ve arama türüne bağlıdır. Seçmeli alanlar mevcut olabilir ve ek alanlar geri alınabilir.
- Geri dönen öğeler ve searchParameters.num, params.num'dan farklı olabilir. Gerçek sonuç sayısını belirlemek için geri dönüş serisini kullanın.

## Yanıt biçimleri

Yanıtlar JSON'u varsayılan olarak kullanır. Bu opsiyonel başlıkları ile başka bir format seçin.

- Accept: application/json (varsayılan) veya veya veya text/plain. Plain text aynı alanları okunabilir, okunabilir bir düzende sunar.
- X-Respond-With: markdown. Orijinal alanlarda başlangıç bırakın. Markdown, yanıt formatı ile çalışır.

Markdown gerçek zamanlı sorgular ve tamamlanmış sonuçlar için mevcuttur.

Aşağıdaki alanlar varsayılan JSON yanıtını tanımlar.

[İstek ve yanıt formatı örnekleri](https://flashdata.dev/tr/docs/guides/response-formats/reference.md#headers)

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

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

## API temelleri

Yukarıdaki istek oluşturucu ve örnekler bu kaynağın parametrelerini kullanır. Python ve cURL örneklerini paylaşılan teslimiyet, durum ve sonuç adımları için kullanın. Bir Batch vücut, sorgu içeren bir JSON nesnedir; her öğe kendi işini döndürür ID.

- [Async isteği ve makbuz](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#async)

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

- [Check job status](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#status)

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

- [Erişim tamamlanmış sonuçlar](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON talep ediyor](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md#batch)
- [Müşteri Açık API](https://flashdata.dev/docs/openapi.json)

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

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

## Tamamlanan bildirimleri tamamlayın

- [Satın alın ve doğrulama webhooks](https://flashdata.dev/tr/docs/guides/async-batch/reference.md#webhooks)

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

## Sorun Giderme

- [Hatalar ve durum kodları](https://flashdata.dev/tr/docs/errors/reference.md#status-codes)
- [Yeniden deneme ne zaman](https://flashdata.dev/tr/docs/errors/reference.md#retries)

## İlgili APIs

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