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

> Listez les articles Content Studio pour les diffuser dans un CMS externe.

Liste les métadonnées des articles Content Studio pour des intégrations en lecture seule. Récupérez le [détail d’un article](/fr/developers/endpoints/content/get) pour obtenir le corps en Markdown.

<Note>
  La route utilise `status=LIVE` par défaut. Passez `status` explicitement pour lister un autre état.
</Note>

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

## Paramètres de chemin

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

## Paramètres de requête

<ParamField query="status" type="string" default="LIVE">
  Filtre par statut : `DRAFT`, `GENERATING`, `LIVE`, `ARCHIVED`
</ParamField>

<ParamField query="articleType" type="string">
  Filtre par type : `INFORMATIONAL`, `COMPARISON`, `HOW_TO`, `LISTICLE`, `REVIEW`, `CASE_STUDY`, `NEWS`, `OPINION`, `OTHER`
</ParamField>

<ParamField query="limit" type="number" default="50">
  Nombre maximal d’articles renvoyés (maximum : 100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Décalage de pagination
</ParamField>

<ParamField query="sort" type="string" default="updatedAt">
  Champ de tri : `createdAt`, `updatedAt`, `publishedAt`, `title`, `wordCount`
</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 d’articles correspondant aux filtres</ResponseField>
    <ResponseField name="count" type="number">Nombre d’articles 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="articles" type="array">
  <Expandable title="Objet article">
    <ResponseField name="id" type="string">Identifiant de l’article (à utiliser avec l’endpoint de détail)</ResponseField>
    <ResponseField name="title" type="string">Titre de l’article</ResponseField>
    <ResponseField name="slug" type="string">Slug d’URL ou `null`</ResponseField>
    <ResponseField name="description" type="string">Courte description ou `null`</ResponseField>
    <ResponseField name="articleType" type="string">Type d’article</ResponseField>
    <ResponseField name="status" type="string">`DRAFT`, `GENERATING`, `LIVE` ou `ARCHIVED`</ResponseField>
    <ResponseField name="wordCount" type="number">Nombre de mots du contenu généré</ResponseField>
    <ResponseField name="finalUrl" type="string">URL de publication (si vous l’avez renseignée) ou `null`</ResponseField>
    <ResponseField name="publishedAt" type="string">Horodatage de publication (ISO 8601) ou `null`</ResponseField>
    <ResponseField name="generatedAt" type="string">Horodatage de génération du contenu (ISO 8601) ou `null`</ResponseField>
    <ResponseField name="createdAt" type="string">Horodatage de création (ISO 8601)</ResponseField>
    <ResponseField name="updatedAt" type="string">Horodatage de dernière mise à jour (ISO 8601)</ResponseField>
  </Expandable>
</ResponseField>

## Exemple de requête

```bash theme={null}
curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/content?status=LIVE&limit=20" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
```

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "pagination": {
    "total": 12,
    "count": 1,
    "limit": 20,
    "offset": 0
  },
  "articles": [
    {
      "id": "art_abc123",
      "title": "How to choose the right solution in 2026",
      "slug": "how-to-choose-the-right-solution-2026",
      "description": "A practical buyer's guide.",
      "articleType": "HOW_TO",
      "status": "LIVE",
      "wordCount": 1480,
      "finalUrl": "https://acme.example/blog/how-to-choose",
      "publishedAt": "2026-05-10T09:00:00.000Z",
      "generatedAt": "2026-05-08T14:22:00.000Z",
      "createdAt": "2026-05-08T13:50:00.000Z",
      "updatedAt": "2026-05-10T09:00:00.000Z"
    }
  ]
}
```

## Erreurs

| Statut | Signification |
| - | - |
| `400` | Paramètre de statut, de type d’article, de pagination ou de tri invalide |
| `401` | Jeton d’API manquant ou invalide |
| `404` | Marque introuvable ou inaccessible |
| `429` | Limite de débit dépassée ; respectez `Retry-After` |

Consultez [Limites de débit](/fr/developers/rate-limits) pour la gestion des nouvelles tentatives.


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