Aller au contenu
FR
Obtenir une clé API
Parcourir la documentation

Premiers pas

Démarrage rapide

Lancez votre première recherche Google et obtenez des résultats structurés pour votre application ou votre agent IA.

Commencez avec votre agent IA

Transmettez ces instructions à un agent disposant d’un terminal. Il configurera FlashData et effectuera une recherche.

Effectuez votre premier appel API

Vous préférez écrire le code ? Suivez ces trois étapes dans votre terminal.

  1. Obtenez une clé API

    Créez un compte, vérifiez votre adresse e-mail et créez une clé autorisant Google Search. Si vous disposez déjà d’une clé, réutilisez-la.

    Exécutez cette commande dans votre terminal et collez la clé dans la saisie masquée. Ignorez cette étape si FLASHDATA_API_KEY est déjà définie.

    Définir votre clé
    # 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. Lancer une recherche

    Choisissez votre langage et exécutez l’exemple dans le même terminal. Chaque exécution effectue une recherche.

    Python 3.10+ · Enregistrez l’exemple dans quickstart.py.

    Installer
    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))
    Exécuter
    python quickstart.py
  3. Vérifiez le résultat

    Une réponse réussie contient status: done. Les sources se trouvent dans results[].organic et les crédits facturés dans usage.credits.

    Exemple de réponse (extrait)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

Essayez la console

  1. Créez un compte ou connectez-vous. Vérifiez votre adresse e-mail et terminez les étapes de configuration affichées dans la console.
  2. Ouvrez Google Search, sélectionnez la source Google Search et le mode Realtime, puis saisissez battery recycling research. Développez Additional parameters et définissez Page size (num) sur 5.
  3. Vérifiez la requête affichée et les crédits disponibles, puis lancez la recherche une seule fois.
  4. Examinez la réponse et la consommation. Ouvrez une source renvoyée pour en vérifier le contenu avant de citer davantage que son extrait.

Allez plus loin

Si la première requête échoue

FLASHDATA_API_KEY manquante
Définissez la clé dans le terminal ou l’environnement qui exécute l’exemple ; ces extraits ne chargent pas les fichiers .env.
401 / 403
Vérifiez que la clé ou la connexion est active et dispose de l’autorisation google_search.
402
Vérifiez les crédits disponibles dans Billing. Rattachez l’essai existant si un accès titulaire est nécessaire.
429
Respectez Retry-After. Conservez la même identité et la même preuve d’inscription ; ne créez pas un autre essai.
Délai dépassé ou résultat de soumission inconnu
Vérifiez l’exécution existante avant de réessayer. Avec la CLI, conservez le profil et l’identifiant d’exécution ; avec un SDK ou l’API, conservez tout identifiant de tâche ou de requête reçu.