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://api.finseo.ai/v1

Quick example

curl --request GET \
  --url https://api.finseo.ai/v1/projects/YOUR_PROJECT_ID/metrics?timeframe=30d \
  --header 'Authorization: Bearer YOUR_API_KEY'
import requests

headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(
    "https://api.finseo.ai/v1/projects/YOUR_PROJECT_ID/metrics",
    headers=headers,
    params={"timeframe": "30d"}
)

data = response.json()["data"]
print(f"Visibility Rate: {data['current']['visibilityRate']}%")
print(f"Mentions: {data['current']['mentions']}")
print(f"Change: {data['changes']['visibilityRateChange']:+.1f}%")
const response = await fetch(
  "https://api.finseo.ai/v1/projects/YOUR_PROJECT_ID/metrics?timeframe=30d",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);

const { data } = await response.json();
console.log(`Visibility: ${data.current.visibilityRate}%`);
console.log(`Mentions: ${data.current.mentions}`);
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

Tracking Prompts

Add the right questions to monitor AI visibility

AI Models

Configure where Finseo runs your prompts

Bot Analytics

Upload server logs and monitor AI crawler access

Human Traffic

Measure visits, conversions, and revenue from AI platforms

Attribution

Send form, CRM, and order attribution into Finseo

Integrations

Connect forms, CRMs, analytics, and attribution sources

Search Console

Extract real user prompts from Google and Bing query data

Products and AI Shopping

Analyze mentioned products, shopping listings, stores, and attributes

Sentiment

Track brand framing, criticism, awards, and aspect scores

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