# Python SDK snelstart

Installeer de Python SDK en print zoekresultaten met een paar regels code. Omvat synchrone en asyncio voorbeelden.

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

- [GitHub](https://github.com/flashdatadev/flashdata-python) — Bron- en SDK-referentie
- [Een API-sleutel aanmaken](https://flashdata.dev/app/api-keys) — Een sleutel aanmaken in de console

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

## Maak uw eerste Python verzoek

Installeer de SDK, stel uw API-sleutel in en voer een zoekopdracht uit. Antwoorden zijn standaard Python woordenboeken.

- [Python SDK referentie](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)
- [PyPI](https://pypi.org/project/flashdata/1.1.0/)

<a id="install"></a>

### Installeer de SDK

Vereist Python 3.10+. Voer deze commando's uit in uw projectmap. Gebruik je al een virtuele omgeving? Installeer flashdata==1.1.0 met de python -m pip van die omgeving in plaats daarvan.

#### Linux / macOS

##### Installeren

```bash
python3 -m venv .venv
.venv/bin/python -m pip install "flashdata==1.1.0"
```


#### Windows PowerShell

##### Installeren

```powershell
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"
```


- [Python installeren](https://www.python.org/downloads/)

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

### Authenticeren

Maak een API sleutel met Google Search toestemming, of hergebruik een geautoriseerde sleutel. Zet het in deze terminal met behulp van de verborgen prompt hieronder.

De prompt overslaan als FLASHDATA_API_KEY al is ingesteld. Deze voorbeelden lezen de variabele direct; ze laden geen .env-bestanden.

#### Bash

##### Verborgen sleutelprompt · Bash

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

##### Verborgen sleutelprompt · PowerShell

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


- [Registreren](https://flashdata.dev/signup)
- [API Keys openen](https://flashdata.dev/app/api-keys)
- [Billing openen](https://flashdata.dev/app/billing)
- [Instellen van het proces van de agent](https://flashdata.dev/nl/docs/guides/agent-onboarding/reference.md)

<a id="query"></a>

### Een zoekopdracht uitvoeren

Sla dit op als quickstart.py en voer het vervolgens uit met dezelfde virtuele omgeving. Het maakt een Google Search verzoek voor maximaal vijf resultaten en print titels, URLs en gebruikte credits.

#### quickstart.py

```python
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)
    for page in response["results"]:
        for hit in page.get("organic", []):
            print(hit["title"], hit["link"])
    print("Credits used:", response["usage"]["credits"])
```

#### Linux / macOS

##### Uitvoeren

```bash
.venv/bin/python quickstart.py
```


#### Windows PowerShell

##### Uitvoeren

```powershell
.\.venv\Scripts\python.exe quickstart.py
```



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

### Het resultaat controleren

Het script eindigt normaal nadat de controlestatus is voltooid. Verwacht brontitels en URLs gevolgd door gebruikte Credits. Een lege organische lijst is een geldig antwoord; de resultaten variëren met uw zoekopdracht.

| Veld | Gebruik |
| --- | --- |
| results[].organic[] | Google Search hits: titel, link en knipsel. Andere bronnen hebben verschillende resultaatvelden. |
| usage.credits | Kosten van dit verzoek. Tot vijf resultaten hier zijn één zoekopdracht. |

#### Voorbeelduitvoer

```text
Battery recycling research https://example.org/recycling
Credits used: 0.02
```


<a id="common-tasks"></a>

## Probeer een andere gegevensbron

Elk tabblad is een compleet script. Vervang quickstart.py door één voorbeeld en voer het uit met het commando van stap 3. Elke run dient een nieuw verzoek in; de sleutel heeft de getoonde bron toestemming nodig.

### Google Nieuws

Vereist google_news. Print artikel titels en bron links van results[].news[].

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.news("battery recycling", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    for page in response["results"]:
        for article in page.get("news", []):
            print(article.get("title"), article.get("link"))
```


### YouTube-metadata

Vereist youtube_metadata. Drukt de videotitel, kanaal en duur in seconden af. Vervang de video ID door een die u wilt inspecteren.

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.youtube.metadata("dQw4w9WgXcQ", include_formats=False)
    if response["status"] != "done":
        raise RuntimeError(response)
    for video in response["results"]:
        print(video.get("title"), video.get("channel"))
        print("Seconds:", video.get("duration"))
```


### YouTube transcript

Vereist youtube_transcript. Drukt een bestaand Engels automatisch transcript af van results[].fullText. De video moet die track hebben; deze call genereert of vertaalt geen bijschriften.

#### quickstart.py

```python
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.youtube.transcript("dQw4w9WgXcQ", language="en", auto=True)
    if response["status"] != "done":
        raise RuntimeError(response)
    for track in response["results"]:
        print(track.get("fullText", ""))
```


- [Alle bronmethoden en parameters](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/sources/index.md)

<a id="features"></a>

## Wat de Python SDK ondersteunt

| Gebruik | SDK entry points |
| --- | --- |
| google / youtube | Google Search, Nieuws, Afbeeldingen, Winkelen, Video's en Plaatsen; YouTube ontdekking, metadata, bijschriften, transcripten en kanaalgegevens. |
| youtube.download | Stuur een audio- of videoleveringstaak naar uw cloudopslag. Vereist youtube_download toestemming en opslag configuratie; volg het volledige download voorbeeld hieronder. |
| jobs / bulk | Bewaar de geaccepteerde taak ID, wacht op voltooiing en haal resultaten op. Gebruik bulk voor grotere video-ID datasets en hervat bestaande taken na een herstart. |
| account | Lees toegang, evenwicht, prijzen, limieten en gebruik voordat u opnieuw werkt. Hergebruik een geautoriseerde sleutel uit uw omgeving of geheime winkel. |
| respond_with / accept | Gebruik respond_with="markdown" voor Markdown in respons["content"], of accepteer="text/plain" voor een string. JSON woordenboeken zijn de standaard. |

- [Complete Python download voorbeeld](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/examples/youtube_download.py)
- [Downloadopslag instellen](https://flashdata.dev/nl/docs/guides/youtube-download-guide/reference.md)
- [Python-responsformaten](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/response-formats.md)

<a id="asyncio"></a>

## Asyncio gebruiken

Vervang quickstart.py door deze versie en gebruik hetzelfde commando. AsyncFlashData stelt dezelfde bronnen bloot met wachten. Dit wacht nog steeds op een real-time zoekrespons; mode="async" geeft in plaats daarvan een server-side achtergrondtaak.

In Jupyter of een applicatie met een draaiende event loop, gebruik wacht main() in plaats van asyncio.run(main()). Hergebruik de client binnen die event-lus.

### quickstart.py

```python
import asyncio
import os
from flashdata import AsyncFlashData

async def main():
    async with AsyncFlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = await client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])

asyncio.run(main())
```

- [Async-clientconfiguratie](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/client.md)

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

## Volgende stappen

- [Accountcontroles en opgeslagen resultaten](https://flashdata.dev/nl/docs/guides/sdk-operations/reference.md)
- [Achtergrondtaken en batch](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/jobs.md)
- [Bulk-datasets](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/bulk.md)
- [Referentie SDK-methode](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/api-reference.md)

<a id="errors"></a>

## Als een stap mislukt

| Probleem | Repareren |
| --- | --- |
| ModuleNotFoundError | Installeer en voer uit met dezelfde tolk: .venv/bin/python -m pip toon flashdata (Windows: .\.venv\Scripts\python.exe -m pip toon flashdata). Noem uw script flashdata.py niet. |
| KeyError: FLASHDATA_API_KEY / 401 | Stel een actieve API sleutel in in dezelfde terminal. Een .env-bestand alleen wordt niet door dit voorbeeld geladen. Gebruik een API sleutel, geen MCP OAuth token. |
| 403 | Geef de bron toestemming die het voorbeeld van deze sleutel vereist. |
| 402 | Controleer Billing op beschikbare credits. Als de toegang tot trials is uitgeput, claimen de verbinding om uw rekeningsaldo te gebruiken. |
| 429 / APIError | Inspecteer error.retry_after en verminder de aanvraagsnelheid. De SDK stuurt elk verzoek eenmaal en probeert het niet automatisch opnieuw. |
| SubmissionUnknownError | Een getimede indiening kan reeds worden aanvaard. Controleer History voordat u het herhaalt; hergebruik een opgeslagen taak ID indien beschikbaar. |
| asyncio.run() / running event loop | Gebruik wacht main() in een notebook of bestaande event loop. Houd asyncio.run(main()) voor een standalone script. |

- [Geschiedenis aanvragen](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [Python fouten en herstel](https://github.com/flashdatadev/flashdata-python/blob/v1.1.0/docs/errors.md)
