Skip to main content

​
Finseo API

Track how your brand appears across ChatGPT, Claude, Perplexity and other AI platforms. The Finseo Customer API lets you retrieve visibility metrics, manage prompts, analyze competitors, and export data.

​
Base URL

https://app.finseo.ai/api/v1

​
Quick example

curl --request GET \
  --url https://app.finseo.ai/api/v1/projects/YOUR_PROJECT_ID/metrics?timeframe=30d \
  --header 'Authorization: Bearer YOUR_API_KEY'
Response: 
{
  "data": {
    "current": {
      "visible": 28,
      "notVisible": 14,
      "mentions": 156,
      "visibilityRate": 66.67,
      "position": 22.4,
      "sentiment": 0.78
    },
    "previous": {
      "visible": 22,
      "visibilityRate": 52.38
    },
    "changes": {
      "visibilityRateChange": 14.29,
      "mentionsChange": 38
    }
  }
}

​
Response format

All endpoints return a consistent JSON envelope:
FieldDescription
dataThe response payload
metaPagination info (when applicable)
errorError details (only on failure)

​
Error codes

CodeStatusDescription
UNAUTHORIZED401Missing or invalid API key
FORBIDDEN403Insufficient scopes
NOT_FOUND404Resource not found
VALIDATION_ERROR400Invalid parameters
RATE_LIMIT_EXCEEDED429Too many requests
PROJECT_ACCESS_DENIED403API key can’t access this project
INTERNAL_ERROR500Server error

Authentication

Create and manage API keys

Rate Limits

Request limits per plan

Customer API

Explore all endpoints

MCP Integration

Connect to Claude Desktop or Cursor