Sujets
Les sujets définissent les questions et thèmes que Mentova surveille pour une marque. Lorsqu'un sujet est créé, des prompts sont automatiquement générés à partir de la phrase d'amorce.
Endpoints
| Méthode | Chemin | Description |
|---|---|---|
GET | /brands/{brandId}/topics | Lister les sujets d'une marque |
POST | /brands/{brandId}/topics | Créer un sujet |
DELETE | /brands/{brandId}/topics/{topicId} | Supprimer un sujet |
GET /brands//topics
curl https://mentova.ai/api/v1/brands/clxabc123/topics \
-H "X-API-Key: mtv_live_votre_cle"
Réponse 200
{
"data": [
{
"id": "clxtopic1",
"brandId": "clxabc123",
"seed": "Quel est le meilleur outil de gestion de projet pour les équipes à distance ?",
"language": "fr",
"country": "FR",
"createdAt": "2026-02-01T09:00:00.000Z"
}
]
}
POST /brands//topics
Crée un nouveau sujet. Mentova génère automatiquement des prompts à partir de la phrase d'amorce.
Corps de la requête
| Champ | Type | Requis | Description |
|---|---|---|---|
seed | string | Oui | Question ou phrase d'amorce (3-200 caractères) |
language | string | Non | Code de langue BCP-47 (2-5 caractères) |
country | string | Non | Code pays ISO 3166-1 alpha-2 (2-5 caractères) |
curl -X POST https://mentova.ai/api/v1/brands/clxabc123/topics \
-H "X-API-Key: mtv_live_votre_cle" \
-H "Content-Type: application/json" \
-d '{
"seed": "Quel est le meilleur outil de gestion de projet pour les équipes à distance ?",
"language": "fr",
"country": "FR"
}'
Réponse 201
{
"data": {
"id": "clxtopic1",
"brandId": "clxabc123",
"seed": "Quel est le meilleur outil de gestion de projet pour les équipes à distance ?",
"language": "fr",
"country": "FR",
"createdAt": "2026-06-01T09:00:00.000Z"
}
}
DELETE /brands//topics/
Supprime définitivement un sujet ainsi que tous ses prompts et exécutions de campagne.
curl -X DELETE https://mentova.ai/api/v1/brands/clxabc123/topics/clxtopic1 \
-H "X-API-Key: mtv_live_votre_cle"
Réponse 200
{
"data": { "deleted": true }
}
Prompts
Les prompts sont les questions individuelles générées automatiquement à partir des sujets. Ils sont envoyés aux LLMs lors des campagnes.
Endpoints
| Méthode | Chemin | Description |
|---|---|---|
GET | /brands/{brandId}/prompts | Lister les prompts avec filtres optionnels |
GET /brands//prompts
Paramètres de requête
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
model | string | - | Filtrer par valeur d'enum du modèle LLM |
status | string | - | Filtrer par statut de prompt |
limit | integer | 50 | Nombre maximum de résultats (max 200) |
offset | integer | 0 | Décalage de pagination |
curl "https://mentova.ai/api/v1/brands/clxabc123/prompts?limit=10&offset=0" \
-H "X-API-Key: mtv_live_votre_cle"
Réponse 200
{
"data": [
{
"id": "clxprompt1",
"text": "Quel logiciel de gestion de projet les équipes distantes préfèrent-elles ?",
"createdAt": "2026-02-01T09:00:00.000Z",
"topic": {
"id": "clxtopic1",
"seed": "Quel est le meilleur outil de gestion de projet pour les équipes à distance ?"
}
}
],
"total": 24,
"limit": 10,
"offset": 0
}