Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Riferimento API

Formati di risposta

Scegli il contenuto JSON strutturato per la tua applicazione o Markdown per un agente AI. Controllare la risposta con due intestazioni.

In questa pagina

Scegli un formato

JSON con i campi di risultato originali è il default. Accept seleziona JSON o testo normale; X-Respond-With: markdown converte il contenuto del risultato in Markdown. Il tuo corpo di richiesta rimane JSON.

RispostaAcceptX-Respond-WithUtilizzare per
JSONapplication/jsonOmissioneParsing campi in codice · default
JSON + Markdownapplication/jsonmarkdownContesto agente con metadati strutturati
Testo in biancotext/plainOmissioneLeggere i campi originali in un terminale
Testo + Markdowntext/plainmarkdownMetodati di lettura e Markdown insieme

Esempi di richiesta e risposta

Queste schede mostrano la stessa ricerca Google in ogni formato. Utilizzare Bash e cURL 7.76+ con FLASHDATA_API_KEY impostato su una chiave che consente google_search. Eseguire un comando invia una ricerca leggibile.

Predefinito. Parsare l'array dei risultati; i campi all'interno di esso dipendono dalla fonte.

Richiesta · 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"}'
Esempio di risposta · valori illustrativi
{
  "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"
}

Endpoints supportati

Le stesse regole si applicano alle fonti di query Google Search e YouTube. Per YouTube Scarica, formattano il record di consegna, non il byte video o audio. API account, Bulk manifesta e parti NDJSON, callback e risposte MCP utilizzano i propri formati.

Punto di arrivoJSON / testo normaleContenuto Markdown
POST /v1/queries/realtimeSupportatoSupportato
GET /v2/jobs/{id}/resultsSupportatoSupportato
POST /v1/queriesRicevuta della sottomissioneIgnorato — selezionarlo quando si leggono i risultati
POST /v1/queries/batchRicevuta della sottomissioneIgnorato — selezionarlo quando si leggono i risultati
GET /v2/jobs/{id}Situazione del lavoroIgnorato — nessun contenuto di risultato qui

Formattare un risultato di lavoro completato

Impostare le intestazioni quando si legge il risultato, anche se li si imposta alla presentazione. Impostare JOB_ID per un lavoro completato che è possibile accedere. Questo GET legge i risultati esistenti senza presentare un'altra query.

Formato richiestoRispondere ai risultati
originale JSON302 con uno storage firmato URL in Location. Prestare che URL separatamente, senza X-API-Key. Risultati memorizzati possono essere gzip-compressi.
Testo normale o l'opzione Markdown200 con il corpo formattato direttamente nella risposta.
Recuperare Markdown dentro 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'

Errori di formattazione

Gli errori API rimangono JSON o application/problem+json, anche quando si richiede un testo semplice. Controllare lo stato HTTP prima di analizzare il formato di successo.

Stato / codiceRisolto
400 · unsupported_representationUtilizzare X-Respond-With: segnare o omettere l'intestazione. Valori come json o testo non sono supportati.
406 · not_acceptableUtilizzare Accept: application/json o text/plain. text/markdown e application/xml non sono supportati.

Dettagli dell'intestazione Accept

Omit Accept o invia */* per ottenere JSON. Le risposte usano UTF-8. Sono supportate gamme di media e pesi q; un charset non supportato restituisce 406 a meno che un altro range accettabile non corrisponda. Content-Type: application/json descrive il corpo della richiesta, non la risposta.

Preferire il testo, consentire JSON
Accept: text/plain; charset=utf-8, application/json;q=0.8