Introduction

L'API REST Mentova offre aux comptes Agency un accès programmatique à toutes leurs données : marques, sujets, campagnes, métriques de visibilité, concurrents, sources, opportunités et avatars d'audience.

URL de base pour chaque requête :

https://mentova.ai/api/v1

Le schéma OpenAPI est disponible à l'adresse /api/v1/openapi.json et peut être importé directement dans Postman, Insomnia ou tout outil compatible OpenAPI.

Qui peut l'utiliser

L'accès à l'API est réservé au plan Agency. Les requêtes effectuées avec une clé appartenant à un autre plan reçoivent une erreur 403 PLAN_REQUIRED.

Enveloppe de réponse

Chaque réponse, qu'elle soit un succès ou une erreur, est un objet JSON.

Succès - ressource unique

{
  "data": { ... }
}

Succès - liste paginée

{
  "data": [ ... ],
  "total": 42,
  "limit": 50,
  "offset": 0
}

Erreur

{
  "error": "Message lisible par un humain",
  "code": "CODE_MACHINE_LISIBLE"
}

Vérifiez toujours le code HTTP en premier. Le champ code identifie le type d'erreur précis pour un traitement programmatique - consultez la référence des erreurs.

Authentification

Toutes les requêtes nécessitent une clé API dans l'en-tête X-API-Key (ou Authorization: Bearer). Consultez Authentification pour savoir comment générer et transmettre vos clés.