Introduction

The Mentova REST API gives Agency plan accounts programmatic access to all their brand data: brands, topics, campaigns, visibility metrics, competitors, sources, opportunities, and audience avatars.

Base URL for every request:

https://mentova.ai/api/v1

The OpenAPI schema is available at /api/v1/openapi.json and can be imported directly into Postman, Insomnia, or any OpenAPI-compatible tool.

Who can use it

API access is gated to the Agency plan. Requests made with a key belonging to any other plan receive a 403 PLAN_REQUIRED error.

Response envelope

Every response, success or error, is a JSON object.

Success - single resource

{
  "data": { ... }
}

Success - paginated list

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

Error

{
  "error": "Human-readable message",
  "code": "MACHINE_READABLE_CODE"
}

Always check the HTTP status code first. The code field identifies the specific error type for programmatic handling - see the Errors reference.

Authentication

All requests require an API key in the X-API-Key header (or Authorization: Bearer). See Authentication for details on generating and sending keys.