> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API de données de réponses et de citations de la recherche IA

> Une infrastructure de données pour observer les surfaces de recherche IA grand public : ChatGPT, Perplexity, Gemini, Google AI Overview, et plus encore.

querying.ai est une API qui répond à une question : **que dit un moteur d'IA quand on lui pose une question ?**
Vous soumettez un prompt destiné à un moteur, et nous renvoyons la réponse de ce moteur ainsi que les sources qu'il a citées.

Elle suit le contrat standard de tâches asynchrones des API de moteurs de réponse : un client existant migre
généralement en changeant simplement l'URL de base et la clé d'API, sans modifier le code. Consultez
[Migrer une intégration existante](/fr/migrating).

## Fonctionnement

Chaque requête est **asynchrone**. Vous soumettez une tâche, nous la mettons en file, un worker interroge le moteur
cible et extrait le résultat, qui vous revient par webhook ou par polling.

<Steps>
  <Step title="Soumettre une tâche">
    `POST /v1/async/task` avec un `taskType` et un `payload`. Vous recevez immédiatement un `id` de tâche, au statut `QUEUED`.
  </Step>

  <Step title="Nous interrogeons le moteur">
    Un worker prend la tâche, interroge le moteur et extrait le texte de la réponse, les sources et les données propres au moteur.
  </Step>

  <Step title="Récupérer le résultat">
    Si vous avez fourni `webhook.url`, nous y envoyons le résultat en POST. Sinon, interrogez
    `GET /v1/async/task/{id}` jusqu'à ce que `status` soit `COMPLETED` ou `FAILED`.
  </Step>
</Steps>

## Ce que vous recevez

Quel que soit le moteur, le cœur utile de chaque résultat a la même forme :

<ResponseField name="text" type="string">
  La réponse du moteur en texte brut.
</ResponseField>

<ResponseField name="sources" type="array">
  Les citations que le moteur a jointes à sa réponse : `position`, `url` et généralement `label`.
</ResponseField>

Chaque moteur ajoute ses propres champs : Google renvoie une enveloppe SERP complète ; ChatGPT et Perplexity peuvent
renvoyer les requêtes de recherche qu'ils ont lancées ; l'onglet IA de Naver renvoie le panneau shopping qu'il a
affiché. Consultez [Moteurs](/fr/engines/overview) pour la forme propre à chaque moteur.

## URL de base

```
https://api.querying.ai
```

Tous les endpoints sauf `/health` et `/ready` exigent un [jeton bearer](/fr/authentication).

<Card title="Commencer ici" icon="rocket" href="/fr/quickstart">
  Soumettez votre première tâche et obtenez un résultat en moins de cinq minutes.
</Card>

## Découvrir les produits

* [Collecte de réponses IA](https://querying.ai/fr/answers)
* [Analyse des preuves de sources](https://querying.ai/fr/source-influence)
* [Suivi GEO](https://querying.ai/fr/monitors)
* [Guide de démarrage de l'API](https://querying.ai/fr/guides/quickstart)
