# FlashData Google Search API

Haal biologische resultaten, gerelateerde vragen en rijke resultaten van Google Search op als gestructureerde JSON. Filter op land, taal en locatie.

Canonische referentie: https://flashdata.dev/nl/docs/sources/google_search
Beoordeeld: 2026-10-23

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

Vereiste brontoestemming: google_search

Vervang YOUR_API_KEY door een API sleutel met deze bronmachtiging en beschikbare credits. Verzoeken uitvoeren op uw server of agent host.

[Authenticatie instellen](https://flashdata.dev/nl/docs/guides/headers-and-authentication/reference.md)

[Een Google-zoekopdracht kiezen en verfijnen](https://flashdata.dev/nl/docs/guides/google-search-guide/reference.md)

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

## Een verzoek versturen

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

## Parameters

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

### Aanvraaginhoud

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Ja | — | Instellen op google_search.  |
| <a id="parameter-query"></a> query | string | Ja | Niet ingesteld | Zoekopdracht. Ondersteunt Google zoekoperators zoals site: en titel:. Min lengte: 1. Maximale lengte: 2000. |
| <a id="parameter-params"></a> params | object | Nee | {} | Settings voor dit verzoek.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Nee | Niet ingesteld | Async en alleen batch. Publieke HTTPS voltooiing URL op poort 443, tot 2,048 tekens. Geen gebruikersgegevens of URL-fragment. Gebruik null of een lege tekenreeks zonder melding. In een batch, zet dit op elke query, buiten params.  |

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

### Land, taal en locatie

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | Nee | Niet ingesteld | Tweeletterige landcode, zoals wij, GB, de of sg. Stel expliciet in om een land te selecteren. Min lengte: 2. Maximale lengte: 2. Patroon: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | Nee | Niet ingesteld | Google interface taal. Stel expliciet in om een taal te selecteren. Min lengte: 1. Maximale lengte: 35. Patroon: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | Nee | Niet ingesteld | Gevraagde zoeklocatie, bij voorkeur een stad, zoals "London, England, United Kingdom". Beschikbaarheid hangt af van het zoektype. Min lengte: 1. Maximale lengte: 200. |

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

### Paginatie

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | Nee | Niet ingesteld | Ik heb gevraagd om het resultaat te tellen. FlashData voegt geen vaste standaard toe als deze wordt weggelaten. Het aantal teruggekeerden kan verschillen door zoekopdracht en zoektype. Minimum: 1. Maximum: 100. |
| <a id="parameter-params-page"></a> params.page | integer | Nee | Niet ingesteld | Opgevraagd resultaat pagina. Stel expliciet in. Elke pagina is een afzonderlijk API verzoek. Minimum: 1. Maximum: 100. |

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

### Zoekfilters

| Parameter | Type | Vereist | Standaard | Omschrijving |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | Nee | Niet ingesteld | Google zoekfilters, zoals qdr:d voor de afgelopen dag of qdr:w voor de afgelopen week. Beschikbaarheid hangt af van het zoektype. Min lengte: 1. Maximale lengte: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | Nee | Niet ingesteld | Vraag spellingcorrectie aan met true of vraag het uit te schakelen met false. Toegepast gedrag hangt af van het zoektype; laat het gedrag van Google achterwege.  |

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

## Lees het resultaat

Bewaar de succesvolle JSON respons als response.json. Sla dit op als read-response.py en voer python read-response.py uit. Het gebruikt alleen de standaardbibliotheek van Python en doet geen nieuw verzoek.

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

## Voorbeeldantwoord

Opgenomen voorbeeld; velden en tellingen zijn afhankelijk van de bron en de gevraagde invoer.
```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"
}
```

## Responsvelden

| Veld | Type | Omschrijving |
| --- | --- | --- |
| source | string | De gevraagde API bron. |
| status | string | gedaan wanneer het real-time verzoek slaagt. |
| created_at | string | Aanmaaktijd voor respons in ISO 8601-formaat. |
| usage.credits | number | Credits in rekening gebracht voor het verzoek, op basis van uw plan. |
| results[0].searchParameters | object | Zoekinstellingen gerapporteerd door Google, met de query geregistreerd als q. Teruggeleverde instellingen kunnen afwijken van de gevraagde waarden. |
| results[0].organic | array | Biologische resultaten met titel, link, knipsel en positie, plus extra velden indien beschikbaar. |
| results[0].peopleAlsoAsk | array · optional | Gerelateerde vragen, met antwoorden en bronlinks indien beschikbaar. |
| results[0].relatedSearches | array · optional | Verwante zoektermen, elk met een zoekveld. |
| results[0].knowledgeGraph | object · optional | Entiteitsinformatie van het kennispanel. |
| results[0].answerBox | object · optional | Geeft een duidelijk antwoord. Velden variëren met het antwoordtype. |

- Beschikbare velden zijn afhankelijk van het zoek- en zoektype. Optionele velden kunnen ontbreken en extra velden kunnen worden teruggegeven.
- Het aantal geretourneerde items en searchParameters.num kunnen afwijken van params.num. Gebruik de geretourneerde array om het werkelijke aantal resultaten te bepalen.

## Antwoordformaten

Antwoorden gebruiken JSON standaard. Kies een ander formaat met deze optionele headers.

- Accept: application/json (standaard) of text/plain. Platte tekst geeft dezelfde velden weer in een leesbare, ingespringde lay-out.
- X-Respond-With: markdown. Laat uitgevallen voor originele velden. Markdown werkt met beide responsformaten.

Markdown is beschikbaar voor real-time queries en voltooide resultaten.

De velden hieronder beschrijven de standaard JSON response.

[Voorbeelden van verzoeken en antwoorden](https://flashdata.dev/nl/docs/guides/response-formats/reference.md#headers)

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

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

## API-basisprincipes

De aanvraagbouwer en voorbeelden hierboven gebruiken de parameters van deze bron. Gebruik hieronder de voorbeelden Python en cURL voor gedeelde inzending, status en resultaatstappen. Een Batch body is een JSON object met queries; elk item geeft zijn eigen job ID terug.

- [Async verzoek en ontvangst](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#async)

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

- [Taakstatus controleren](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#status)

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

- [Gereedgemaakte resultaten ophalen](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON verzoeken](https://flashdata.dev/nl/docs/reference/batch-and-bulk/reference.md#batch)
- [Klant OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Aanmeldingen tot voltooiing

- [Ontvang en verifieer complete webhooks](https://flashdata.dev/nl/docs/guides/async-batch/reference.md#webhooks)

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

## Problemen oplossen

- [Fouten en statuscodes](https://flashdata.dev/nl/docs/errors/reference.md#status-codes)
- [Wanneer opnieuw proberen](https://flashdata.dev/nl/docs/errors/reference.md#retries)

## Gerelateerde API's

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