Überspringen zum Inhalt
DE
API-Schlüssel
Dokumentation durchsuchen

API-Referenz

Antwortformate

Wählen Sie strukturiertes JSON für Ihre Anwendung oder Markdown-Inhalte für einen AI-Agenten. Kontrollieren Sie die Antwort mit zwei Headern.

Auf dieser Seite

Wählen Sie ein Format

JSON mit ursprünglichen Ergebnisfeldern ist der Standard. Accept wählt JSON oder Klartext; X-Respond-With: Markdown konvertiert den Ergebnisinhalt in Markdown. Ihre Anfrage Körper bleibt JSON.

AntwortAcceptX-Respond-WithVerwendung für
JSONapplication/jsonAuslassenParing-Felder im Code · Standard
JSON + Markdownapplication/jsonmarkdownAgent Kontext mit strukturierten Metadaten
Klartexttext/plainAuslassenLesen von Originalfeldern in einem Terminal
Text + Markdowntext/plainmarkdownMetadaten und Markdown zusammen lesen

Anfrage- und Antwortbeispiele

Diese Registerkarten zeigen das gleiche Google Search in jedem Format. Verwenden Sie Bash und cURL 7.76+, wobei FLASHDATA_API_KEY auf einen Schlüssel gesetzt ist, der google_search ermöglicht. Durch Ausführen eines Befehls wird eine abrechenbare Suche gesendet.

Ausfall. Parse das Ergebnis-Array; die Felder im Inneren hängen von der Quelle ab.

Anfrage · 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"}'
Beispielantwort · Veranschaulichungswerte
{
  "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"
}

Unterstützte Endpunkte

Die gleichen Regeln gelten für Google Search und YouTube Abfragequellen. Für YouTube Download formatieren sie den Lieferdatensatz, nicht die Video- oder Audiobytes. Konto-APIs, Bulk-Manifeste und NDJSON-Teile, Rückrufe und MCP-Antworten verwenden ihre eigenen Formate.

EndpunktJSON / KlartextMarkdown-Gehalt
POST /v1/queries/realtimeUnterstütztUnterstützt
GET /v2/jobs/{id}/resultsUnterstütztUnterstützt
POST /v1/queriesEingangsbestätigungIgnoriert - Wählen Sie es beim Lesen von Ergebnissen
POST /v1/queries/batchEingangsbestätigungIgnoriert - Wählen Sie es beim Lesen von Ergebnissen
GET /v2/jobs/{id}StellenstatusIgnoriert — kein Ergebnis Inhalt hier

Formatieren Sie ein abgeschlossenes Jobergebnis

Legen Sie die Header beim Lesen des Ergebnisses fest, auch wenn Sie sie bei der Einreichung festlegen. Setzen Sie JOB_ID auf einen abgeschlossenen Job, auf den Sie zugreifen können. Dieser GET liest vorhandene Ergebnisse, ohne eine weitere Abfrage einzureichen.

Angefordertes FormatErgebnisantwort
Original JSON302 mit signiertem Speicher URL in Location. Holen Sie sich URL separat, ohne X-API-Key. Gespeicherte Ergebnisse können gzip-komprimiert werden.
Klartext oder entweder Markdown Option200 mit dem formatierten Körper direkt in der Antwort.
Markdown innerhalb von 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'

Formatfehler

API Fehler bleiben JSON oder application/problem+json, auch wenn Sie Klartext anfordern. Überprüfen Sie den HTTP-Status, bevor Sie das Erfolgsformat analysieren.

Status/CodeFixpunkt
400 · unsupported_representationVerwenden Sie X-Respond-With: Markdown oder Weglassen des Headers. Werte wie json oder text werden nicht unterstützt.
406 · not_acceptableAccept verwenden: application/json oder text/plain. text/markdown und application/xml werden nicht unterstützt.

Accept Header Details

Lassen Sie Accept aus oder senden Sie */*, um JSON zu erhalten. Antworten verwenden UTF-8. Medienbereiche und q-Gewichte werden unterstützt; ein nicht unterstütztes Zeichenwerk gibt 406 zurück, es sei denn, ein anderer akzeptabler Bereich stimmt überein. Content-Type: application/json beschreibt den Request Body, nicht die Antwort.

Text vorziehen, JSON zulassen
Accept: text/plain; charset=utf-8, application/json;q=0.8