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

Premiers pas

Démarrage avec l’API

Appelez directement les API Google Search et YouTube en HTTP. Envoyez une requête et lisez la réponse JSON, sans SDK.

  1. Authentifiez-vous

    Créez un compte, vérifiez votre adresse e-mail et créez une clé autorisant Google Search. Vous pouvez réutiliser une clé existante.

    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. Lancez une recherche

    Choisissez un client et exécutez l’exemple dans le même terminal. Chaque exemple envoie une requête POST à https://data.flashdata.dev/v1/queries/realtime et affiche la réponse JSON. Utilisez X-API-Key pour l’authentification et Content-Type: application/json pour envoyer du JSON.

    cURL 7.76+ · Bash sous Linux, macOS ou Git Bash. Collez la commande et exécutez-la.

    Recherche · 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. Vérifiez le résultat

    Vérifiez la réussite HTTP et status: done. Lisez les titres, liens et extraits des sources dans results[].organic, et les crédits facturés dans usage.credits.

    Une liste results ou organic vide avec status: done constitue un résultat vide valide.

    Exemple de réponse
    {
      "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" confirme que la requête s’est terminée avec succès.
    results[0].organic[]
    Résultats de recherche. Vérifiez que results n’est pas vide avant d’accéder à un élément par son index.
    title / link / snippet
    Titre, URL et extrait de la source.
    usage.credits
    Crédits réellement facturés pour cette requête.

Enregistrer une réponse pour le débogage

Pour enregistrer la prochaine requête que vous comptez effectuer, ajoutez ces options à la commande cURL ci-dessus. Examinez les fichiers avant de décider de retenter une requête en échec.

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

Vérifier l’accès et les crédits

Ces requêtes GET lisent l’identité, le solde et les tarifs sans consommer de crédits de requête. Vérifiez le code HTTP 200 et les champs ci-dessous avant de soumettre une tâche facturable.

Lecture du compte : https://api.flashdata.dev/v2. Requêtes de données : https://data.flashdata.dev/v1. Les deux utilisent X-API-Key ; les requêtes POST en JSON utilisent aussi Content-Type: application/json.

Vérifications gratuites · 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
Vérifiez le compte accountId attendu, access: "ready", la présence de "google_search" dans scopes et la date expiresAt éventuelle. accountType vaut "owned" pour une clé du compte propriétaire ou "temporary" pour une clé d’essai.
balance
Lisez availableCredits. Toutes les clés de ce compte utilisent le même solde.
pricing
Dans prices[0], vérifiez que source vaut google_search et que available vaut true. Comparez estimatedCredits pour requestCount: 1 avec availableCredits. Les tarifs et le solde peuvent changer avant la soumission.

Étapes suivantes

Si une étape échoue

Lisez la réponse affichée dans le terminal. Les exemples JavaScript et Python écrivent les erreurs HTTP et Retry-After sur stderr. Chaque exemple soumet une seule requête, sans nouvelle tentative automatique.

Commande introuvable ou option non prise en charge
Vérifiez la version requise par l’exemple choisi. Utilisez PowerShell 7 plutôt que Windows PowerShell 5.1, ou Bash avec cURL 7.76+. JavaScript nécessite Node 22+ et Python nécessite la version 3.10+. Installez l’environnement manquant depuis sa page officielle, rouvrez le terminal et définissez à nouveau la clé.
Clé manquante / 401
Définissez FLASHDATA_API_KEY dans ce processus, puis vérifiez à nouveau l’identité. Fournissez la clé API active complète, sans préfixe Bearer. Si elle a expiré ou a été révoquée, utilisez un identifiant actuellement autorisé ; ne le collez pas dans la conversation.
403
Vérifiez la présence de google_search dans identity.scopes et la valeur ready dans access. Demandez au propriétaire la permission manquante ; modifier la source dans la requête n’accorde aucun accès.
402
Relisez le solde et comparez-le au tarif actuel. Le propriétaire peut consulter la facturation. Si l’essai est épuisé, rattachez la connexion à un compte propriétaire ; créer un autre essai ne permet pas de récupérer cet accès.
400 / 422
Lisez le message d’erreur renvoyé. Vérifiez l’hôte de données exact, la méthode POST, Content-Type et les noms des champs JSON. Utilisez des guillemets droits et une valeur numérique pour params.num, puis corrigez la requête rejetée.
429
Respectez Retry-After s’il est présent ; sinon, espacez progressivement les tentatives avec une limite et réduisez les requêtes simultanées. Ne multipliez pas les appels, les clés ou les essais pour contourner la limite.
HTTP 200 avec un état d’échec ou une erreur
Lisez l’erreur dans le corps de la réponse et conservez tout identifiant de requête ou de tâche. Un corps JSON correctement analysé ne prouve pas la réussite de la tâche et ne justifie pas une nouvelle soumission automatique.
Résultats vides
Si status vaut done, l’authentification a fonctionné. Conservez le résultat vide ou essayez une recherche plus large, qui constituera une nouvelle requête facturable.
Délai dépassé, connexion perdue, erreur 5xx ou HTML au lieu de JSON
Un POST peut avoir été accepté même si sa réponse a été perdue. Recherchez la requête d’origine dans l’historique et conservez les identifiants renvoyés avant de décider de la soumettre à nouveau. Les vérifications GET gratuites peuvent être retentées. Vérifiez que l’URL utilise data.flashdata.dev, et non l’hôte du site web ; ne désactivez pas la vérification TLS.