> ## 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.

# Lister les enregistrements Query Fan-Out

> Listez les requêtes de recherche web agrégées, enregistrées pendant que les fournisseurs généraient leurs réponses.

Renvoie les requêtes de recherche web conservées et associées aux réponses enregistrées. Les résultats sont regroupés par texte de requête normalisé et incluent des compteurs de présence ainsi qu’un libellé de priorité défini par l’API.

<Note>
  Les résultats sont agrégés par requête (sans tenir compte de la casse ni des espaces de début et de fin). Chaque ligne représente une requête unique, tous fournisseurs et réponses confondus.
</Note>

<ParamField header="Authorization" type="string" required>
  Jeton bearer. Exemple : `Bearer qw-api-xxx`
</ParamField>

```http theme={null}
GET /api/v1/brands/{brandId}/search
```

## Paramètres de chemin

<ParamField path="brandId" type="string" required>
  L’identifiant unique de la marque
</ParamField>

## Paramètres de requête

<ParamField query="period" type="number">
  Nombre de jours à inclure. Sans valeur, toutes les données sont renvoyées.
</ParamField>

<ParamField query="startDate" type="string">
  Date de début au format `YYYY-MM-DD`. Fournissez-la avec `endDate` ; une borne seule est actuellement ignorée. Choisissez soit `period`, soit la paire de dates complète.
</ParamField>

<ParamField query="endDate" type="string">
  Date de fin au format `YYYY-MM-DD`. Fournissez-la avec `startDate` ; une borne seule est actuellement ignorée. Ne combinez pas la paire de dates complète avec `period`.
</ParamField>

<ParamField query="provider" type="string">
  Filtre par un ou plusieurs alias de fournisseurs ou identifiants de modèles, séparés par des virgules.
</ParamField>

<ParamField query="limit" type="number" default="50">
  Nombre maximal de requêtes renvoyées (maximum : 100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Nombre de résultats à ignorer pour la pagination
</ParamField>

<ParamField query="sort" type="string" default="occurrences">
  Champ de tri : `occurrences`, `priority`, `brandPresence`, `query`, `createdAt`
</ParamField>

<ParamField query="order" type="string" default="desc">
  Ordre de tri : `asc` ou `desc`
</ParamField>

## Réponse

<ResponseField name="success" type="boolean">
  Indique si la requête a réussi
</ResponseField>

<ResponseField name="pagination" type="object">
  <Expandable title="Informations de pagination">
    <ResponseField name="total" type="number">Nombre total de requêtes uniques correspondant aux filtres</ResponseField>
    <ResponseField name="count" type="number">Nombre de requêtes dans cette réponse</ResponseField>
    <ResponseField name="limit" type="number">Nombre maximal d’éléments par page</ResponseField>
    <ResponseField name="offset" type="number">Nombre d’éléments ignorés</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="searches" type="array">
  <Expandable title="Objet de requête">
    <ResponseField name="query" type="string">La requête de recherche utilisée par l’IA</ResponseField>
    <ResponseField name="occurrences" type="number">Nombre d’apparitions de cette requête dans l’ensemble des réponses</ResponseField>
    <ResponseField name="priority" type="string">Niveau de priorité : `very-high` (concurrents présents, marque absente), `high` (les deux présents), `medium` (marque seule), `low` (aucun des deux)</ResponseField>
    <ResponseField name="brandPresence" type="number">Nombre de réponses où le domaine de la marque est cité comme source</ResponseField>
    <ResponseField name="competitorPresence" type="number">Nombre de réponses où des concurrents directs sont mentionnés</ResponseField>
    <ResponseField name="competitors" type="array">Noms des concurrents directs distincts</ResponseField>
    <ResponseField name="uniquePrompts" type="number">Nombre de prompts distincts associés à cette requête</ResponseField>
    <ResponseField name="prompts" type="array">Objets prompt associés, avec `id` et `text`</ResponseField>
    <ResponseField name="uniqueAnswers" type="number">Nombre de réponses IA distinctes contenant cette requête</ResponseField>
    <ResponseField name="uniqueModels" type="number">Nombre de modèles IA distincts ayant généré cette requête</ResponseField>
    <ResponseField name="models" type="array">Identifiants des modèles associés à la requête</ResponseField>
    <ResponseField name="topics" type="array">Noms des Topics associés</ResponseField>
    <ResponseField name="tags" type="array">Noms des Tags associés</ResponseField>
    <ResponseField name="firstSeen" type="string">Première occurrence (horodatage ISO 8601)</ResponseField>
    <ResponseField name="lastSeen" type="string">Occurrence la plus récente (horodatage ISO 8601)</ResponseField>
  </Expandable>
</ResponseField>

## Exemple de requête

```bash theme={null}
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/search?limit=10&sort=priority" \
  -H "Authorization: Bearer qw-api-your-token-here"
```

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "pagination": {
    "total": 142,
    "count": 2,
    "limit": 10,
    "offset": 0
  },
  "searches": [
    {
      "query": "enterprise analytics platforms comparison",
      "occurrences": 12,
      "priority": "very-high",
      "brandPresence": 0,
      "competitorPresence": 8,
      "competitors": ["Orbit Systems"],
      "uniquePrompts": 5,
      "prompts": [{ "id": "prompt_analytics", "text": "Which analytics platforms are commonly compared?" }],
      "uniqueAnswers": 12,
      "uniqueModels": 3,
      "models": ["openai-gpt-6.1-sol", "anthropic-claude-4.6-sonnet", "google-gemini-3-pro"],
      "topics": ["Analytics"],
      "tags": ["Comparison"],
      "firstSeen": "2026-07-01T10:30:00.000Z",
      "lastSeen": "2026-07-15T10:30:00.000Z"
    },
    {
      "query": "northstar analytics pricing",
      "occurrences": 5,
      "priority": "medium",
      "brandPresence": 3,
      "competitorPresence": 0,
      "competitors": [],
      "uniquePrompts": 2,
      "prompts": [{ "id": "prompt_pricing", "text": "What pricing information is available?" }],
      "uniqueAnswers": 5,
      "uniqueModels": 2,
      "models": ["openai-gpt-6.1-sol", "google-gemini-3-pro"],
      "topics": ["Pricing"],
      "tags": [],
      "firstSeen": "2026-07-05T09:15:00.000Z",
      "lastSeen": "2026-07-14T09:15:00.000Z"
    }
  ]
}
```

<Note>
  `priority` est un classement déterministe fondé sur `brandPresence` et `competitorPresence`. Considérez-le comme une aide au tri, pas comme une prévision d’impact métier.
</Note>

## Erreurs

| Statut | Code | Description |
| - | - | - |
| 400 | `INVALID_PARAMETER` | Valeur de filtre, de pagination ou de tri invalide |
| 401 | erreur de passerelle | Échec de l’authentification |
| 404 | `BRAND_NOT_FOUND` | Marque inexistante ou inaccessible |
| 429 | erreur de passerelle | Limite de débit dépassée ; respectez `Retry-After` |


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