Découvrez les recherches lancées par Perplexity pour répondre

Capturez la réponse de Perplexity à chaque prompt sur votre marché, avec ses sources numérotées, les recherches effectuées et les questions de suivi qu’il propose.

Ce que vous obtenez

• text et markdown : la réponse complète, en texte brut et mise en forme.
• sources : les sources numérotées derrière la réponse, chacune avec son URL, son titre et une courte description.
• related_queries : les questions de suivi que Perplexity propose ensuite.
• Images, vidéos, lieux, hôtels et fiches produits dès que la réponse en affiche.

Fonctionnement

Perplexity répond à chaque question par une recherche web, et ses sources numérotées montrent précisément d’où vient chaque affirmation. Chaque tâche pose votre question depuis le pays choisi et renvoie la réponse et ses sources telles que les voient les gens de ce marché.

Activez include.searchQueries pour recevoir aussi les recherches lancées par Perplexity, qui révèlent comment il découpe une question en étapes de recherche.

Cas d’usage

• Identifiez les domaines sur lesquels Perplexity s’appuie dans votre catégorie et la place de vos pages parmi ses sources.
• Transformez les questions de suivi proposées en nouveaux prompts à suivre.
• Comparez les recommandations de Perplexity avec celles de ChatGPT et Gemini sur les mêmes prompts.

Envoyer la requête

Envoyez la requête avec votre clé API dans l’en-tête Authorization.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "PERPLEXITY",
    "payload": {
      "prompt": "Recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with sources. Keep it under 180 words.",
      "country": "US",
      "include": { "markdown": true }
    }
  }'

Champs de la requête

taskTypestringObligatoire

Le moteur à interroger, par exemple CHATGPT ou GOOGLE.

payload.promptstringObligatoire

La question, rédigée comme un utilisateur la tape dans le chat. Jusqu’à 100 000 caractères.

payload.countrystring

Code pays à deux lettres du marché d’où part la question, par exemple US, KR ou JP. Par défaut US.

payload.include.markdownboolean

Avec true, la réponse arrive aussi en markdown, avec ses titres, listes, tableaux et liens.

payload.include.searchQueriesboolean

Avec true, vous recevez aussi searchQueries : les recherches web lancées par le moteur pour rédiger sa réponse.

webhook.urlstring

Une adresse HTTPS de votre serveur. La tâche terminée y est envoyée dès qu’elle se termine.

idempotencyKeystring

Votre identifiant pour la requête. Chaque clé crée une seule tâche par compte : un envoi répété reste une seule tâche.

Réponse

Voici une tâche terminée, raccourcie pour la lecture.

{
  "success": true,
  "task": {
    "id": "67030796-8ecd-4aed-b2c4-6ced6639a313",
    "taskType": "PERPLEXITY",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:24.023Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "text": "For commuting, I’d choose **Sony for strongest all-around isolation**, **Bose for maximum ANC comfort**, or **AirPods for Apple integration**.",
    "markdown": "| Earbuds | Noise cancellation | Battery life* | Best for |\n|---|---|---:|---|\n| **Sony WF-1000XM5** | Excellent; measured 32 dB attenuation in key transit-noise frequencies | 8h / 24h case | Android and mixed devices |\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://www.rtings.com/headphones/reviews/best/wireless-earbuds",
        "label": "The 6 Best Wireless Earbuds of 2026 - RTINGS.com",
        "description": "The best wireless earbuds we've tested are the Sony WF-1000XM6. These buds offer top-tier ANC performance."
      },
      {
        "position": 2,
        "url": "https://www.businessinsider.com/guides/tech/best-earbuds",
        "label": "The best earbuds of 2026, tested by audio experts - Business Insider",
        "description": "The best wireless earbuds offer great audio quality in a compact design. These are our top picks from Sony, Bose, Technics, Anker, Apple, and JLab."
      }
    ]
  }
}

task.statusstring

QUEUED, PROCESSING, puis COMPLETED avec la réponse ou FAILED avec error.

credits.creditsChargedinteger

Crédits facturés pour la tâche terminée. Une tâche en échec facture 0.

response.textstring

La réponse en texte brut.

response.markdownstring

La réponse avec sa mise en forme : titres, listes, tableaux et liens.

response.sourcesarray

Les pages citées par la réponse, dans l’ordre du moteur, avec position, url et label.

response.searchQueriesarray

Les recherches web lancées par le moteur pour rédiger la réponse.

Recevoir le résultat

La requête renvoie aussitôt la tâche avec status QUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.

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

Tarif

Chaque tâche Perplexity terminée utilise 1 crédit.