> ## 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 Perplexity : réponses, citations et requêtes de recherche

> Posez une question à Perplexity et recevez sa réponse, les sources citées, les questions associées, les requêtes de recherche et les médias.

`PERPLEXITY` interroge Perplexity et renvoie la réponse avec les sources citées et les recherches lancées par son modèle.

| | |
| - | - |
| taskType | `PERPLEXITY` |
| Lit | `prompt` (se rabat sur `query`) |
| Crédits | 1 |
| Pays | Facultatif, `US` par défaut. `CN` est refusé avec `422 REGION_UNSUPPORTED`. |

## Requête

```bash theme={"theme":"css-variables"}
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": "best CRM for a small team", "country": "US", "include": { "searchQueries": true } } }'
```

## Réponse

| Champ | Type | Description |
| - | - | - |
| `text` | string | La réponse. Toujours présent. |
| `sources` | array | Sources citées : `position`, `url`, `label`, `description`. Toujours présent. |
| `related_queries` | string\[] | Les questions de suivi suggérées par Perplexity. |
| `search_model_queries` | array | Les recherches lancées par le modèle de Perplexity, chacune `{ query, engine, limit }`. |
| `searchQueries` | string\[] | Les mêmes recherches en chaînes simples. Uniquement avec `include.searchQueries`. |
| `images`, `videos` | array | Médias affichés avec la réponse : `title`, `url`, `medium`, `image`, `thumbnail`, `source`, `image_width`, `image_height`, et `duration` pour une vidéo. |
| `markdown` | string | La réponse en Markdown, images en place. Uniquement avec `include.markdown`. |
| `rawResponse` | array | Événements de flux analysés. Uniquement avec `include.rawResponse`. |

Dans `images` et `videos`, `url` est la page d'où vient l'élément et `image` est l'image elle-même.

Par exemple :

```json theme={"theme":"css-variables"}
{
  "text": "HubSpot CRM and Pipedrive are the most common choices for small teams ...",
  "sources": [
    { "position": 1, "url": "https://www.example.com/crm-review", "label": "Best CRM for small teams", "description": "..." }
  ],
  "related_queries": ["Is HubSpot CRM free?"],
  "search_model_queries": [{ "query": "best CRM small team", "engine": "web", "limit": 8 }],
  "searchQueries": ["best CRM small team"]
}
```

`related_queries` sont des suggestions destinées à l'utilisateur. `search_model_queries` et `searchQueries` sont ce que Perplexity a réellement recherché.

## Flags include

| Flag | Effet |
| - | - |
| `markdown` | Ajoute `markdown`. |
| `searchQueries` | Ajoute `searchQueries`. |
| `rawResponse` | Ajoute `rawResponse`. |
| `html` | Ajoute `html`, l'écran affiché par Perplexity, pour 0,25 crédit quand la page est enregistrée. Consultez [Pages HTML](/fr/engines/html-pages.md). |
| `analysis` | Ajoute `analysis`, 1 crédit. Consultez [Analyse de la réponse](/fr/engines/answer-analysis.md). |
| `citationAnalysis` | Lance une [Citation Analysis](/fr/research/citation-analysis.md) sur la réponse. |

`ads` et `shopping` n'ont aucun effet. Consultez [Réponses Markdown et brutes](/fr/engines/response-options.md).

## Voir aussi

* [Page produit Perplexity](https://querying.ai/fr/engines/perplexity)
* [Vue d'ensemble des moteurs](/fr/engines/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.