Guide de démarrage de l’API de données de recherche IA

Créez une clé, envoyez une question et recevez la réponse par interrogation ou webhook.

Commencer gratuitement Lire la documentation ↗

Vous soumettez une tâche

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer vt_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "GEMINI",
    "payload": { "prompt": "best wireless earbuds 2026" },
    "webhook": { "url": "https://yours.app/hooks/querying" }
  }'

Votre webhook reçoit

{
  "task": {
    "id": "8f2c1e40-…",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-07-17T04:12:00.000Z"
  },
  "credits": { "creditsToCharge": 1.25, "creditsCharged": 1.25 },
  "response": {
    "text": "The best wireless earbuds in 2026 are …",
    "sources": [
      { "position": 1,
        "url": "https://example.com/review",
        "label": "Best earbuds, reviewed" }
    ],
    "timing": { "totalMs": 7400 }
  }
}

1. Préparer la clé API

Créez un compte gratuit et générez une clé dans le tableau de bord. Enregistrez-la dans la variable d’environnement serveur QUERYING_API_KEY et utilisez-la depuis le serveur. Les nouveaux comptes reçoivent 500 crédits avant l’ajout d’un moyen de paiement.

2. Envoyer une question

La commande envoie une question à Gemini avec FR comme pays. Le texte conserve la langue dans laquelle vous le rédigez. Utilisez le task.id de l’accusé de réception à l’étape suivante.

cURL

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "taskType": "GEMINI",
  "payload": {
    "prompt": "meilleurs écouteurs sans fil pour les trajets",
    "country": "FR"
  }
}'

3. Récupérer le résultat

Remplacez TASK_ID par l’identifiant reçu. Pour QUEUED ou PROCESSING, recommencez après un délai. Pour COMPLETED, lisez response ; pour FAILED, traitez l’erreur. Récupérez et conservez le résultat dans les 24 heures suivant sa fin.

cURL

curl https://api.querying.ai/v1/async/task/TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

4. Recevoir les résultats par webhook

Ajoutez webhook.url au JSON et préparez un récepteur HTTPS avec la vérification de signature documentée. Il y a jusqu’à 5 tentatives : l’envoi initial et 4 nouvelles tentatives avec délai croissant. Dédupliquez les livraisons avec task.id.

JSON

{
  "taskType": "GEMINI",
  "payload": {
    "prompt": "meilleurs écouteurs sans fil pour les trajets",
    "country": "FR"
  },
  "webhook": {
    "url": "https://your-server.example.com/querying-webhook"
  }
}

5. Ajouter des moteurs et des mesures régulières

Vérifiez taskType, prompt ou query, pays pris en charge et structure de réponse de chaque moteur. Résolvez les limites de solde ou de concurrence avant de réessayer. Enregistrez un ensemble fixe de questions dans Monitors pour suivre la visibilité de marque.

Conçu pour ces équipes

Une source de données structurée pour les équipes qui analysent la recherche IA.

Monitoring GEO et AEO

Suivez comment les moteurs de recherche IA mentionnent votre marque, vos produits et vos concurrents, par moteur, pays et prompt.

Veille concurrentielle

Voyez quelles marques les moteurs IA citent et quels produits ils recommandent sur votre marché.

Tableaux de bord agences

Surveillez des dizaines de clients simultanément avec les APIs batch et les webhooks, tous moteurs et régions confondus.

Recherche et analyse

Étudiez le comportement de recherche IA par marché avec des données structurées pour la recherche, la stratégie de contenu et le SEO.

Tous les cas d'usage →

Fonctionnalités associées

Commencez avec 500 crédits offerts

Lancez votre première tâche dans le Playground, ou appelez l'API avec votre clé.

Commencer gratuitement Voir les tarifs