Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Per iniziare

Avvio rapido

Esegui la tua prima ricerca Google e ottieni risultati strutturati per la tua applicazione o il tuo agente IA.

Inizia con il tuo agente AI

Passa queste istruzioni a un agente con accesso al terminale. Configura FlashData ed esegue una ricerca.

Fai la tua prima chiamata API

Preferisci scrivere il codice? Segui questi tre passaggi nel terminale.

  1. Ottieni una chiave API

    Crea un account, verifica l’e-mail e crea una chiave con il permesso Google Search. Se hai già una chiave, riutilizzala.

    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

    Scegli il linguaggio ed esegui l’esempio nello stesso terminale. Ogni esecuzione invia una ricerca.

    Python 3.10+ · Salvare l'esempio come quickstart.py.

    Installa
    python -m pip install "flashdata==1.1.0"
    quickstart.py
    import json
    import os
    from flashdata import FlashData
    
    with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        print(json.dumps(response, indent=2))
    Esegui
    python quickstart.py
  3. Verifica il risultato

    Una risposta riuscita contiene status: done. Trovi le fonti in results[].organic e i crediti addebitati in usage.credits.

    Esempio di risposta (abbreviato)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

Prova la console

  1. Crea un account o accedi. Verifica e-mail completa e qualsiasi configurazione dell'account mostrata nella console.
  2. Apri Google Search, seleziona la fonte Google Search e la modalità Realtime, poi inserisci battery recycling research. Espandi Additional parameters e imposta Page size (num) su 5.
  3. Controllare la richiesta visualizzata e i crediti disponibili, quindi eseguire la ricerca una volta.
  4. Ispezionare la risposta e l'uso. Aprire una fonte restituita per controllare il suo contenuto prima di citare più del suo estratto.

Continua dal tuo primo risultato

Se la prima richiesta fallisce

Manca FLASHDATA_API_KEY
Impostare la chiave nello stesso terminale o runtime dell'esempio; i file .env non sono caricati da questi frammenti.
401 / 403
Controllare che la chiave o la connessione sia attiva e abbia il permesso google_search.
402
Controlla i crediti disponibili in Billing. Collega la prova esistente a un account quando serve l’accesso del titolare.
429
Rispetta Retry-After. Conserva la stessa identità e la stessa prova di registrazione; non avviare un’altra prova.
Timeout o presentazione sconosciuta
Controlla l’esecuzione esistente prima di riprovare. Con la CLI, mantieni lo stesso profilo e ID di esecuzione; con SDK/API, conserva ogni ID di operazione o richiesta restituito.