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

# Obtenir les suggestions de prompts

> Lisez la dernière génération Prompt Studio d’un workspace : les 20 recommandations par défaut, davantage du lot noté avec limit, et la taille du lot.

Renvoie la dernière génération de Prompt Studio du workspace. Les suggestions arrivent dans cet ordre : les 20 recommandations d’abord, puis le reste du lot noté. Par défaut, la réponse contient les 20 recommandations. Définissez `limit` pour lire davantage du lot, jusqu’à 500 suggestions ; `total` donne la taille du lot entier. Tant qu’aucune génération n’existe, `run` est absent et `suggestions` est un tableau vide ; lancez-en une avec [Générer des suggestions de prompts](https://docs.qwairy.co/fr/developers/endpoints/prompt-suggestions/generate.md).

Disponible avec les offres Growth, Agency Growth, Business, Agency Business et Enterprise. Consultez [Authentification](https://docs.qwairy.co/fr/developers/authentication.md).

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**brandId** `string` *required*

Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.

**focus** `string` (default: balanced)

`balanced`, `DISCOVERY`, `CONSIDERATION`, `PERCEPTION` ou `AUTHORITY`.

**limit** `integer` (default: 20)

Nombre maximal de suggestions renvoyées, recommandations d’abord. Un entier de 1 à 500.

## Réponse

**run** `object`

La génération dont proviennent ces suggestions. Absente tant qu’aucune génération n’existe. Mêmes champs que [Obtenir une génération de suggestions](https://docs.qwairy.co/fr/developers/endpoints/prompt-suggestions/get-run.md).

**focus** `string`

L’orientation appliquée à l’ordre

**total** `integer`

Nombre de suggestions du lot entier pour cette orientation, quelle que soit la limite

**suggestions** `array`

Les recommandations d’abord, puis le reste du lot, coupé à `limit`.

**Suggestion**

**id** `string`

Identifiant de la suggestion, utilisé par [Accepter des suggestions de prompts](https://docs.qwairy.co/fr/developers/endpoints/prompt-suggestions/accept.md)

**text** `string`

Texte du prompt suggéré

**topic** `string | null`

Nom du Topic suggéré

**keywordId** `string | null`

Identifiant du Topic existant, lorsque le Topic suggéré est déjà configuré

**funnelStage** `string | null`

Étape du tunnel du prompt

**intent** `string | null`

Intention de recherche du prompt

**score** `integer`

Score de la suggestion, de 0 à 100

**reason** `string | null`

Raison pour laquelle le prompt a été suggéré

**recommended** `boolean`

Indique si la suggestion fait partie des 20 recommandations

**tracked** `boolean`

`true` lorsqu’un prompt équivalent est actif et suivi. Un prompt équivalent archivé ou en pause donne `false` : accepter la suggestion réactive ce prompt et renvoie `created`

## Requête et réponse synthétiques

```bash theme={null}
curl "https://www.qwairy.co/api/v1/brands/$BRAND_ID/prompt-suggestions?focus=DISCOVERY&limit=1" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
```

```json theme={null}
{
  "run": {
    "id": "bbbbbbbb-0000-4000-8000-000000000000",
    "status": "COMPLETED",
    "source": "manual",
    "keywordId": null,
    "recommendations": 20,
    "createdAt": "2026-10-12T09:00:00.000Z",
    "completedAt": "2026-10-12T09:02:00.000Z"
  },
  "focus": "DISCOVERY",
  "total": 48,
  "suggestions": [
    {
      "id": "cccccccc-0000-4000-8000-000000000000",
      "text": "Which CRM tools support small sales teams?",
      "topic": "CRM software",
      "keywordId": null,
      "funnelStage": "TOFU",
      "intent": "Discovery",
      "score": 88,
      "reason": "Covers a common comparison question for the category.",
      "recommended": true,
      "tracked": false
    }
  ]
}
```

## Erreurs

| Statut | Code | Cause |
| - | - | - |
| `400` | `INVALID_PARAMETER` | `focus` ne fait pas partie des valeurs listées, ou `limit` n’est pas un entier de 1 à 500 |
| `401` | Corps plat | Jeton absent ou invalide |
| `403` | `INSUFFICIENT_PLAN` | Refus d’offre générique : `"This endpoint is not included in the team's plan."` |
| `404` | `BRAND_NOT_FOUND` | Le workspace est absent ou inaccessible |

Les erreurs de lecture utilisent les formes plate ou imbriquée décrites dans [Codes d’erreur](https://docs.qwairy.co/fr/developers/errors.md). Sur `429`, respectez `Retry-After`.


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