Documentatie bekijken
API-referentie
Kies gestructureerde JSON voor uw toepassing of Markdown-inhoud voor een AI-agent. Controleer de reactie met twee headers.
Op deze pagina
Kies een formaat
JSON met originele resultaatvelden is de standaard. Accept selecteert JSON of platte tekst; X-Respond-With: markdown converteert het resultaat naar Markdown. Uw aanvraag lichaam blijft JSON.
| Antwoord | Accept | X-Respond-With | Gebruik voor |
|---|---|---|---|
| JSON | application/json | Omit | Velden ontleden in code · standaard |
| JSON + Markdown | application/json | markdown | Agent context met gestructureerde metadata |
| Gewone tekst | text/plain | Omit | Originele velden in een terminal lezen |
| Tekst + Markdown | text/plain | markdown | Metadata en Markdown samen lezen |
Vraag- en antwoordvoorbeelden
Deze tabbladen tonen dezelfde Google Search in elk formaat. Gebruik Bash en cURL 7.76+ met FLASHDATA_API_KEY ingesteld op een sleutel waarmee google_search. Het uitvoeren van een commando dient een factureerbare zoekopdracht in.
Standaard. Ontleden van de resultaten array; de velden in het afhankelijk van de bron.
curl --fail-with-body --silent --show-error \
'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{"source":"google_search","query":"vector databases"}'{
"source": "google_search",
"status": "done",
"results": [
{
"organic": [
{
"title": "Example page",
"link": "https://example.com/article",
"snippet": "A short source snippet."
}
]
}
],
"usage": {
"credits": 0.01
},
"created_at": "2026-10-22T12:00:00.000Z"
}Lees inhoud als een Markdown string. Het vervangt resultaten; bron, status en gebruik blijven beschikbaar als JSON velden.
curl --fail-with-body --silent --show-error \
'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'X-Respond-With: markdown' \
--data '{"source":"google_search","query":"vector databases"}'{
"source": "google_search",
"status": "done",
"usage": {
"credits": 0.01
},
"created_at": "2026-10-22T12:00:00.000Z",
"content": "# Google search\n\n## Organic\n\n### 1. Example page\n\n**Link:** <https://example.com/article>\n\n**Snippet:** A short source snippet\\.\n"
}Lees het antwoord als tekst. Het bevat de originele velden in een ingespringde lay-out, geen JSON document.
curl --fail-with-body --silent --show-error \
'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Content-Type: application/json' \
--header 'Accept: text/plain' \
--data '{"source":"google_search","query":"vector databases"}'Source: "google_search"
Status: "done"
Results:
1:
Organic:
1:
Title: "Example page"
Link: "https://example.com/article"
Snippet: "A short source snippet."
Usage:
Credits: 0.01
Created at: "2026-10-22T12:00:00.000Z"
Lees het antwoord als tekst: metadata eerst, gevolgd door Markdown inhoud.
curl --fail-with-body --silent --show-error \
'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Content-Type: application/json' \
--header 'Accept: text/plain' \
--header 'X-Respond-With: markdown' \
--data '{"source":"google_search","query":"vector databases"}'Source: "google_search"
Status: "done"
Usage: {"credits":0.01}
Created at: "2026-10-22T12:00:00.000Z"
Markdown Content:
# Google search
## Organic
### 1. Example page
**Link:** <https://example.com/article>
**Snippet:** A short source snippet\.
Ondersteunde eindpunten
Dezelfde regels gelden voor Google Search en YouTube query sources. Voor YouTube Download formatteren ze de leveringsrecord, niet de video of audio bytes. Account API's, Bulk manifesten en NDJSON delen, callbacks en MCP antwoorden gebruiken hun eigen formaten.
| Eindpunt | JSON / platte tekst | Markdown-inhoud |
|---|---|---|
| POST /v1/queries/realtime | Ondersteund | Ondersteund |
| GET /v2/jobs/{id}/results | Ondersteund | Ondersteund |
| POST /v1/queries | Ontvangst van de indiening | Negeer het bij het lezen van de resultaten |
| POST /v1/queries/batch | Ontvangst van de indiening | Negeer het bij het lezen van de resultaten |
| GET /v2/jobs/{id} | Functiestatus | Negeer hier geen inhoud van het resultaat |
Formatteer een voltooid taakresultaat
Stel de headers in bij het lezen van het resultaat, zelfs als je ze bij het indienen van de headers instelt. Stel JOB_ID in op een voltooide baan waar u toegang tot kunt krijgen. Deze GET leest bestaande resultaten zonder een andere query in te dienen.
| Aangevraagd formaat | Resultaatrespons |
|---|---|
| Originele JSON | 302 met een ondertekende opslag URL in Locatie. Haal die URL apart op, zonder X-API-Key. De opgeslagen resultaten kunnen gzip-gecomprimeerd zijn. |
| Gewone tekst of een Markdown-optie | 200 met de geformatteerde body direct in het antwoord. |
curl --fail-with-body --silent --show-error \
"https://api.flashdata.dev/v2/jobs/${JOB_ID:?Set JOB_ID}/results" \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
--header 'Accept: application/json' \
--header 'X-Respond-With: markdown'Formaatfouten
API-fouten blijven JSON of application/problem+json, zelfs wanneer u om platte tekst verzoekt. Controleer de HTTP-status voordat u het succesformaat ontleedt.
| Status / code | Repareren |
|---|---|
| 400 · unsupported_representation | Gebruik X-Respond-With: markeer of laat de header weg. Waarden zoals json of tekst worden niet ondersteund. |
| 406 · not_acceptable | Gebruik Accept: application/json of text/plain. text/markdown en application/xml worden niet ondersteund. |
Accept header details
Accept of stuur */* om JSON te krijgen. Antwoorden gebruiken UTF-8. Mediabereiken en q-gewichten worden ondersteund; een niet-ondersteunde tekenset geeft 406 terug, tenzij een ander aanvaardbaar bereik overeenkomt. Content-Type: application/json beschrijft het verzoek, niet het antwoord.
Accept: text/plain; charset=utf-8, application/json;q=0.8