Obtenir un contenu
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/content/{articleId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/content/{articleId}"
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/{articleId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"brand": {},
"article": {
"id": "<string>",
"title": "<string>",
"slug": "<string>",
"description": "<string>",
"content": "<string>",
"articleType": "<string>",
"status": "<string>",
"targetLength": 123,
"wordCount": 123,
"guidelines": "<string>",
"includeTldr": true,
"includeFaq": true,
"metaData": {},
"outline": {},
"finalUrl": "<string>",
"publishedAt": "<string>",
"generatedAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"sources": [
{}
]
}
}Contenu
Obtenir un contenu
Récupérez un article Content Studio complet, corps en Markdown compris.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
content
/
{articleId}
Obtenir un contenu
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/content/{articleId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/content/{articleId}"
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/{articleId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"brand": {},
"article": {
"id": "<string>",
"title": "<string>",
"slug": "<string>",
"description": "<string>",
"content": "<string>",
"articleType": "<string>",
"status": "<string>",
"targetLength": 123,
"wordCount": 123,
"guidelines": "<string>",
"includeTldr": true,
"includeFaq": true,
"metaData": {},
"outline": {},
"finalUrl": "<string>",
"publishedAt": "<string>",
"generatedAt": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"sources": [
{}
]
}
}Renvoie un article Content Studio avec son
Un
Consultez Limites de débit pour la gestion des nouvelles tentatives.
content en Markdown, son plan, ses métadonnées et ses sources.
string
requis
Jeton bearer. Exemple :
Bearer qw-api-xxxParamètres de chemin
string
requis
L’identifiant unique de la marque
string
requis
L’identifiant unique de l’article
Réponse
boolean
Indique si la requête a réussi
object
id, name, domainobject
Afficher Article
Afficher Article
string
Identifiant de l’article
string
Titre de l’article
string
Slug d’URL ou
nullstring
Courte description ou
nullstring
Corps complet de l’article en Markdown
string
Type d’article
string
DRAFT, GENERATING, LIVE ou ARCHIVEDnumber
Nombre de mots cible utilisé pour la génération
number
Nombre de mots réel
string
Consignes de génération ou
nullboolean
Indique si un TL;DR a été demandé
boolean
Indique si une FAQ a été demandée
object
Métadonnées SEO et d’initialisation (JSON) ou
nullobject
Plan structuré avec
sections, ou nullstring
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)
array
Sources utilisées pour l’article. Chaque objet a
id, title, url, usageType, order.404 RESOURCE_NOT_FOUND est renvoyé si l’article n’existe pas ou n’appartient pas à la marque.
Exemple de requête
curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/content/ARTICLE_ID" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
Exemple de réponse
{
"success": true,
"brand": {
"id": "brand_01",
"name": "Acme Analytics",
"domain": "acme.example"
},
"article": {
"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.",
"content": "# How to choose the right solution in 2026\n\n## Introduction\n\n...",
"articleType": "HOW_TO",
"status": "LIVE",
"targetLength": 1500,
"wordCount": 1480,
"guidelines": null,
"includeTldr": true,
"includeFaq": false,
"metaData": {
"seo": {
"metaTitle": "How to choose the right solution (2026 guide)",
"metaDescription": "A practical buyer's guide for 2026."
}
},
"outline": {
"sections": [
{ "id": "s1", "level": 2, "title": "Introduction", "order": 0 }
],
"generatedAt": "2026-05-08T14:20:00.000Z"
},
"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",
"sources": [
{
"id": "src_1",
"title": "Industry benchmark report",
"url": "https://research.example/benchmark",
"usageType": "AUTO",
"order": 0
}
]
}
}
Erreurs
| Statut | Signification |
|---|---|
401 | Jeton d’API manquant ou invalide |
404 | Marque ou article introuvable |
429 | Limite de débit dépassée ; respectez Retry-After |