Thema's

Thema's bepalen de vragen en onderwerpen die Mentova voor een merk volgt. Zodra een thema wordt aangemaakt, worden er automatisch prompts gegenereerd op basis van de seed-zin.

Endpoints

GET /brands//topics

curl https://mentova.ai/api/v1/brands/clxabc123/topics \
  -H "X-API-Key: mtv_live_votre_cle"

Antwoord 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

Maakt een nieuw thema aan. Mentova genereert automatisch prompts op basis van de seed-zin.

Aanvraagbody

language en country bepalen de markt van het thema (land + taal); ontbreken ze, dan wordt de belangrijkste markt van het merk gebruikt. Een markt die het merk niet volgt, wordt geweigerd (400, code MARKET_NOT_TRACKED): voeg deze eerst toe in de merkinstellingen, of via de API met het veld markets van PATCH /brands/{brandId}. Zie Markten.

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"
  }'

Antwoord 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/

Verwijdert een thema definitief, samen met alle bijbehorende prompts en campagne-uitvoeringen.

curl -X DELETE https://mentova.ai/api/v1/brands/clxabc123/topics/clxtopic1 \
  -H "X-API-Key: mtv_live_votre_cle"

Antwoord 200

{
  "data": { "deleted": true }
}

Prompts

Prompts zijn de individuele vragen die automatisch op basis van thema's worden gegenereerd. Ze worden tijdens campagnes naar de LLM's gestuurd.

Endpoints

GET /brands//prompts

Queryparameters

curl "https://mentova.ai/api/v1/brands/clxabc123/prompts?limit=10&offset=0" \
  -H "X-API-Key: mtv_live_votre_cle"

Antwoord 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
}