Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

API-referentie

Antwoordformaten

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.

AntwoordAcceptX-Respond-WithGebruik voor
JSONapplication/jsonOmitVelden ontleden in code · standaard
JSON + Markdownapplication/jsonmarkdownAgent context met gestructureerde metadata
Gewone teksttext/plainOmitOriginele velden in een terminal lezen
Tekst + Markdowntext/plainmarkdownMetadata 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.

Aanvraag · cURL / Bash
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"}'
Voorbeeld respons · illustratieve waarden
{
  "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"
}

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.

EindpuntJSON / platte tekstMarkdown-inhoud
POST /v1/queries/realtimeOndersteundOndersteund
GET /v2/jobs/{id}/resultsOndersteundOndersteund
POST /v1/queriesOntvangst van de indieningNegeer het bij het lezen van de resultaten
POST /v1/queries/batchOntvangst van de indieningNegeer het bij het lezen van de resultaten
GET /v2/jobs/{id}FunctiestatusNegeer 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 formaatResultaatrespons
Originele JSON302 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-optie200 met de geformatteerde body direct in het antwoord.
Markdown ophalen binnen JSON · cURL / Bash
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 / codeRepareren
400 · unsupported_representationGebruik X-Respond-With: markeer of laat de header weg. Waarden zoals json of tekst worden niet ondersteund.
406 · not_acceptableGebruik 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.

Voorkeur voor tekst, laat JSON
Accept: text/plain; charset=utf-8, application/json;q=0.8