Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Per iniziare

Avvio rapido API

Chiama le API Google e YouTube direttamente sopra HTTP. Inviare una richiesta e leggere la risposta JSON; non è richiesto alcun SDK.

  1. Autentico

    Crea un account, verifica la tua e-mail e crea una chiave con il permesso di ricerca Google. È possibile riutilizzare una chiave esistente.

    Esegui il comando nel terminale e incolla la chiave nel campo nascosto. Salta questo passaggio se FLASHDATA_API_KEY è già impostata.

    Imposta la chiave
    # 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
  2. Esegui una ricerca

    Scegliere un client e eseguire l'esempio nello stesso terminale. Ciascuno invia una richiesta POST a https://data.flashdata.dev/v1/queries/realtime e stampa JSON. Autenticare con X-API-Key; inviare JSON con Content-Type: application/json.

    cURL 7.76+ · Bash su Linux, macOS o Git Bash. Incolla e scappa.

    Ricerca · Bash / cURL
    curl --fail-with-body --silent --show-error --max-time 70 \
      --request POST https://data.flashdata.dev/v1/queries/realtime \
      --header "X-API-Key: $FLASHDATA_API_KEY" \
      --header 'Content-Type: application/json' \
      --data '{
      "source": "google_search",
      "query": "battery recycling research",
      "params": {
        "num": 5
      }
    }'
  3. Verifica il risultato

    Conferma il successo HTTP e status: done. Leggere i titoli, i link e i frammenti di origine in results[].organic, e l'addebito in usage.credits.

    Un risultato vuoto o un elenco organico con status: done è un risultato vuoto valido.

    Esempio
    {
      "source": "google_search",
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    status
    "done" conferma la query completata con successo.
    results[0].organic[]
    Risultati di ricerca. Controllare che i risultati non sono inutili prima di indicizzarlo.
    title / link / snippet
    Titolo di origine, URL ed estratto.
    usage.credits
    Crediti effettivi addebitati per questa domanda.

Salvare una risposta per il debug

Per catturare la successiva richiesta prevista, aggiungere queste opzioni al comando cURL sopra. Ispezionare i file prima di decidere di riprovare una richiesta fallita.

cURL
--dump-header response-headers.txt --output result.json

Controllare l'accesso e i crediti

Queste richieste GET leggono identità, equilibrio e prezzi senza utilizzare crediti di query. Aspettatevi HTTP 200 e controlla i campi sottostanti prima di inviare il lavoro pagato.

L'account legge: https://api.flashdata.dev/v2. Richieste di dati: https://data.flashdata.dev/v1. Entrambi usano X-API-Key; Le richieste JSON POST utilizzano anche Content-Type: application/json.

Controlli gratuiti · Bash
(
for endpoint in 'identity' 'balance' 'pricing?source=google_search&request_count=1'; do
  printf '\n%s\n' "$endpoint"
  curl --fail-with-body --silent --show-error --max-time 20 \
    --header "X-API-Key: $FLASHDATA_API_KEY" \
    --write-out '\nHTTP %{http_code}\n' \
    "https://api.flashdata.dev/v2/api-access/$endpoint" || exit
done
)
identity
Confermare gli obiettivi accountId, access: "ready", gli ambiti contenenti "google_search", e qualsiasi expiresAt. accountType è "owned" per una chiave di prova o "temporary" per una chiave di prova.
balance
Leggi availableCredits. Tutte le chiavi di questo account utilizzano lo stesso equilibrio.
pricing
Per i prezzi[0], la fonte di conferma è google_search e disponibile è true. Confronta estimatedCredits per requestCount: 1 con availableCredits. I prezzi e gli saldi possono cambiare prima della presentazione.

Prossimo passo

Se un passo fallisce

Leggi la risposta stampata nel tuo terminale. Gli errori JavaScript e Python riportano gli errori HTTP e Retry-After a stderr. Ogni esempio si presenta una volta; non si riprova automaticamente.

Comando opzione mancante o non supportato
Controllare la versione richiesta nell'esempio selezionato. Utilizzare PowerShell 7 piuttosto che Windows PowerShell 5.1, o utilizzare Bash con cURL 7.76+. JavaScript ha bisogno di Node 22+; Python ha bisogno di 3.10+. Installare il runtime mancante dalla sua pagina di download ufficiale, riaprire il terminale, quindi impostare nuovamente la chiave.
Chiave mancante / 401
Impostare FLASHDATA_API_KEY in questo processo e controllare nuovamente l'identità. Fornire il tasto API attivo completo, senza un prefisso Bearer. Se è scaduto o è stato revocato, utilizzare una credenziale autorizzata corrente; non incollarlo in chat.
403
Controllare identity.scopes per google_search e l'accesso per pronto. Richiedere il permesso mancante dal proprietario; cambiare la fonte nella richiesta non garantisce l'accesso.
402
Leggi di nuovo l'equilibrio e confrontalo con il prezzo attuale. Il proprietario può controllare Billing. Una prova esausta ha bisogno di accesso del proprietario attraverso la rivendicazione; la creazione di una prova sostitutivo non è il recupero.
400 / 422
Leggi il messaggio di errore restituito. Controllare l'host dati esatto, il metodo POST, i nomi dei campi Content-Type e JSON. Utilizzare le citazioni rette e una params.num numerico, quindi correggere la richiesta rifiutata.
429
Rispettare Retry-After se presente; altrimenti utilizzare un backoff limitato e ridurre la convalutazione. Non loop rapidamente, creare nuove chiavi o registrare un altro prova per bypassare il limite.
HTTP 200 con stato o errore guasti
Leggi l'errore nel corpo e conserva qualsiasi richiesta o lavoro ID. Non trattare un corpo di JSON parso come un compito di successo o resubmit automaticamente.
Risultati vuoti
Se lo stato è fatto, l'autenticazione ha funzionato. Mantenere il risultato vuoto o provare una domanda più ampia come una nuova richiesta a pagamento.
Timeout, perdita di connessione, 5xx o HTML invece di JSON
A POST può essere stato accettato anche se la sua risposta è stata persa. Controllare History per la query originale e conservare qualsiasi IDs restituito prima di decidere di rivendere. I controlli GET gratuiti possono essere riattivati. Confermare che URL utilizza data.flashdata.dev, non l'host del sito web, e non disabilitare la verifica TLS.