Lister les contenus
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/content \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/content"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/content', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"pagination": {
"total": 123,
"count": 123,
"limit": 123,
"offset": 123
},
"articles": [
{
"id": "<string>",
"title": "<string>",
"slug": "<string>",
"description": "<string>",
"articleType": "<string>",
"status": "<string>",
"wordCount": 123,
"finalUrl": "<string>",
"publishedAt": "<string>",
"generatedAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>"
}
]
}Contenu
Lister les contenus
Listez les articles Content Studio pour les diffuser dans un CMS externe.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
content
Lister les contenus
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/content \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/content"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/content', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"pagination": {
"total": 123,
"count": 123,
"limit": 123,
"offset": 123
},
"articles": [
{
"id": "<string>",
"title": "<string>",
"slug": "<string>",
"description": "<string>",
"articleType": "<string>",
"status": "<string>",
"wordCount": 123,
"finalUrl": "<string>",
"publishedAt": "<string>",
"generatedAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>"
}
]
}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 pour obtenir le corps en Markdown.
Consultez Limites de débit pour la gestion des nouvelles tentatives.
La route utilise
status=LIVE par défaut. Passez status explicitement pour lister un autre état.string
requis
Jeton bearer. Exemple :
Bearer qw-api-xxxParamètres de chemin
string
requis
L’identifiant unique de la marque
Paramètres de requête
string
défaut:"LIVE"
Filtre par statut :
DRAFT, GENERATING, LIVE, ARCHIVEDstring
Filtre par type :
INFORMATIONAL, COMPARISON, HOW_TO, LISTICLE, REVIEW, CASE_STUDY, NEWS, OPINION, OTHERnumber
défaut:"50"
Nombre maximal d’articles renvoyés (maximum : 100)
number
défaut:"0"
Décalage de pagination
string
défaut:"updatedAt"
Champ de tri :
createdAt, updatedAt, publishedAt, title, wordCountstring
défaut:"desc"
Ordre de tri :
asc ou descRéponse
boolean
Indique si la requête a réussi
object
array
Afficher Objet article
Afficher Objet article
string
Identifiant de l’article (à utiliser avec l’endpoint de détail)
string
Titre de l’article
string
Slug d’URL ou
nullstring
Courte description ou
nullstring
Type d’article
string
DRAFT, GENERATING, LIVE ou ARCHIVEDnumber
Nombre de mots du contenu généré
string
URL de publication (si vous l’avez renseignée) ou
nullstring
Horodatage de publication (ISO 8601) ou
nullstring
Horodatage de génération du contenu (ISO 8601) ou
nullstring
Horodatage de création (ISO 8601)
string
Horodatage de dernière mise à jour (ISO 8601)
Exemple de requête
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
{
"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 |

