# Snelstart

Voer je eerste Google-zoekopdracht uit en ontvang gestructureerde resultaten voor je app of AI-agent.

Canonische referentie: https://flashdata.dev/nl/docs/guides/quickstart
Beoordeeld: 2026-11-04 door FlashData

<a id="agent"></a>

## Begin met je AI-agent

Geef deze prompt aan een agent met terminaltoegang. Die stelt FlashData in en voert één zoekopdracht uit.

### Prompt voor installatie en de eerste taak

```text
Lees https://flashdata.dev/auth.md en volg de FlashData-installatie-instructies voor deze omgeving. Hergebruik bestaande toegang; start alleen als die ontbreekt één proefperiode als je daarvoor in aanmerking komt. Zoek op Google naar "battery recycling research" met maximaal vijf resultaten. Geef de brontitels, URL’s en daadwerkelijk gebruikte credits terug. Bewaar inloggegevens in beveiligde opslag, nooit in de chat. Meld bij geblokkeerde toegang de volgende stap in plaats van een nieuwe proefperiode aan te maken.
```

- [MCP instellen](https://flashdata.dev/nl/docs/integrations/mcp-clients/reference.md)
- [Skills voor agents](https://flashdata.dev/nl/docs/guides/agent-skill/reference.md)

<a id="application"></a>

## Je eerste API-aanroep uitvoeren

Schrijf je liever zelf de code? Volg deze drie stappen in je terminal.


<a id="api-key"></a>

### Een API-sleutel aanmaken

Maak een account, verifieer je e-mailadres en maak een sleutel met Google Search-toestemming. Heb je al een sleutel? Gebruik die hier.

Voer dit uit in je terminal en plak je sleutel in de verborgen invoer. Sla deze stap over als FLASHDATA_API_KEY al is ingesteld.

#### Bash

##### Je sleutel instellen

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```


#### PowerShell 7

##### Je sleutel instellen

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```


- [Een account aanmaken](https://flashdata.dev/signup)
- [API Keys openen](https://flashdata.dev/app/api-keys)

<a id="request"></a>

### Een zoekopdracht uitvoeren

Kies je programmeertaal en voer het voorbeeld uit in dezelfde terminal. Elke uitvoering verzendt één zoekopdracht.

#### Python

Python 3.10+ · Sla het voorbeeld op als quickstart.py.

##### Installeren

```bash
python -m pip install "flashdata==1.1.0"
```

##### quickstart.py

```python
import json
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.search("battery recycling research", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    print(json.dumps(response, indent=2))
```

##### Uitvoeren

```bash
python quickstart.py
```


#### TypeScript

Node.js 22.18+ · Begin in een lege map en sla quickstart.mts op.

##### Instellen

```bash
npm init -y
npm install --save-exact @flashdata-dev/sdk@1.1.0
```

##### quickstart.mts

```typescript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.google.search({
  query: 'battery recycling research', num: 5,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(JSON.stringify(response, null, 2));
```

##### Uitvoeren

```bash
node quickstart.mts
```


#### JavaScript

Node.js 22+ · Begin in een lege map en sla quickstart.mjs op.

##### Instellen

```bash
npm init -y
npm install --save-exact @flashdata-dev/sdk@1.1.0
```

##### quickstart.mjs

```javascript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.google.search({
  query: 'battery recycling research', num: 5,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(JSON.stringify(response, null, 2));
```

##### Uitvoeren

```bash
node quickstart.mjs
```


#### Go

Go 1.25+ · Begin in een lege map en sla main.go op. Sla go mod init over in een bestaande module.

##### Instellen

```bash
go mod init example.com/flashdata-quickstart
go get github.com/flashdatadev/flashdata-go@v1.1.0
```

##### main.go

```go
package main

import (
    "context"
    "encoding/json"
    "log"
    "os"
    "time"

    flashdata "github.com/flashdatadev/flashdata-go"
)

func main() {
    key := os.Getenv("FLASHDATA_API_KEY")
    if key == "" {
        log.Fatal("Set FLASHDATA_API_KEY through your server's secret manager.")
    }
    client, err := flashdata.New(flashdata.Options{APIKey: key})
    if err != nil {
        log.Fatal(err)
    }
    ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
    defer cancel()
    result, err := client.Google.Search(ctx, flashdata.GoogleSearchInput{
        Query: "battery recycling research",
        Params: &flashdata.GoogleSearchParams{Num: flashdata.Ptr(int64(5))},
    })
    if err != nil {
        // Do not automatically resubmit an uncertain paid request.
        log.Fatal(err)
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil {
        log.Fatal(err)
    }
    if result.Status != "done" {
        log.Fatalf("Search did not complete: %s", result.Status)
    }
}
```

##### Uitvoeren

```bash
go run .
```


#### HTTP API

Geen SDK nodig. Voer de opdracht voor Bash / cURL 7.76+ of voor PowerShell 7 uit.

##### Bash / cURL

```bash
curl --fail-with-body --silent --show-error \
  --request POST https://data.flashdata.dev/v1/queries/realtime \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"source":"google_search","query":"battery recycling research","params":{"num":5}}'
```

##### PowerShell 7

```powershell
$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}'
$flashdataResult = Invoke-RestMethod -Method Post -Uri 'https://data.flashdata.dev/v1/queries/realtime' -Headers @{ 'X-API-Key' = $env:FLASHDATA_API_KEY } -ContentType 'application/json' -Body $flashdataRequest
$flashdataResult | ConvertTo-Json -Depth 20
```


- [Het resultaat hieronder controleren](https://flashdata.dev/nl/docs/guides/quickstart/reference.md#result)

<a id="result"></a>

### Het resultaat controleren

Een geslaagd antwoord bevat status: done. Bronnen staan in results[].organic en het verbruik in usage.credits.

#### Voorbeeldantwoord (ingekort)

```json
{
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Battery recycling research",
          "link": "https://example.org/recycling",
          "snippet": "An example search excerpt."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  }
}
```

- [Je zoekopdracht verbeteren](https://flashdata.dev/nl/docs/guides/google-search-guide/reference.md)
- [YouTube Data proberen](https://flashdata.dev/nl/docs/guides/youtube-data-guide/reference.md)
- [API-instellingen en probleemoplossing](https://flashdata.dev/nl/docs/guides/http-quickstart/reference.md)

<a id="console"></a>

## De console proberen

1. Maak een account of log in. Verifieer je e-mailadres en voltooi de accountinstellingen die de console toont.
2. Open Google Search, kies de bron Google Search en de modus Realtime en voer battery recycling research in. Open Additional parameters en stel Page size (num) in op 5.
3. Controleer de getoonde aanvraag en je beschikbare credits. Voer de zoekopdracht daarna één keer uit.
4. Bekijk het antwoord en het verbruik. Open een teruggegeven bron om de inhoud te controleren voordat je meer citeert dan het fragment.

- [Een account aanmaken](https://flashdata.dev/signup)
- [Google Search openen](https://flashdata.dev/app/google-search)

<a id="next"></a>

## Verder bouwen op je eerste resultaat

- [Zoeken met filters](https://flashdata.dev/nl/docs/guides/google-search-guide/reference.md)
- [YouTube-gegevens verkennen](https://flashdata.dev/nl/docs/guides/youtube-data-guide/reference.md)
- [Zoeken aan een app toevoegen](https://flashdata.dev/nl/docs/guides/search-in-an-app/reference.md)

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

## Als de eerste aanvraag mislukt

| Wat je ziet | Wat je moet doen |
| --- | --- |
| FLASHDATA_API_KEY ontbreekt | Stel de sleutel in dezelfde terminal of runtime in als het voorbeeld. Deze fragmenten laden geen .env-bestanden. |
| 401 / 403 | Controleer of de sleutel of verbinding actief is en google_search-toestemming heeft. |
| 402 | Controleer je beschikbare credits in Billing. Koppel een bestaande proefperiode als toegang van de eigenaar nodig is. |
| 429 | Volg Retry-After. Behoud dezelfde identiteit en hetzelfde registratiebewijs; maak geen nieuwe proefperiode aan. |
| Timeout of onduidelijke verzendstatus | Controleer de bestaande uitvoering voordat je opnieuw probeert. CLI-gebruikers behouden hetzelfde profiel en dezelfde uitvoerings-ID; SDK/API-gebruikers bewaren elke teruggegeven taak- of aanvraag-ID. |

