Developer Platform · API

The AI Visibility API for programmatic AEO & GEO data

One REST API for projects, prompts, metrics, competitors, sources and exports across ChatGPT, Claude, Perplexity and Gemini. Base URL https://api.finseo.ai/v1.

Get an API keyRead the docs
  • REST + JSON · stable v1
  • Bearer auth with scoped keys
  • SHA-256 hashed credentials
curl https://api.finseo.ai/v1/projects \
  --header "Authorization: Bearer sk_live_…"

Join 500+ ambitious teams winning the AI search era.

For brandsFor agencies
Würth
Kellogg's
Panasonic
Livefresh
Raiffeisen
Jägermeister
Dethleffs
Snocks
Trustpilot
Bloomwell
Lavita
Enpal
Lidl
Küche&Co
Otto Office
Christoph Sterkel, Head of Europe, Kellogg's
Kellogg's

Winning in LLMs

across every market

Why the Finseo API

One REST API for the entire AI visibility stack.

Pull projects, prompts, metrics, competitors, sources, tags, fan-outs, attribution, tasks and bulk exports through a single, well-versioned REST surface. No per-platform clients to maintain.

  • 10

    Endpoint groups

    Projects → Export

    Full surface area of the platform

  • 5+

    AI platforms tracked

    ChatGPT, Claude, Perplexity, Gemini, Google AI

    All accessible through one API

  • Bearer

    Auth model

    with read / write / export scopes

    SHA-256 hashed, project-scoped keys

  • 1

    Response shape

    Predictable JSON envelope

    data · meta · error on every endpoint

Endpoints

Ten endpoint groups, one base URL.

Every path below lives under https://api.finseo.ai/v1 and returns the same JSON envelope. The scope next to each route is what the key needs.

01Projects

Tracked brands and domains your key can access.

  • GET/projectsread
  • POST/projectswrite
  • GET/projects/{id}read
  • PUT/projects/{id}write

02Prompts

Tracked prompts with visibility metrics, and new ones to track.

  • GET/projects/{id}/promptsread
  • POST/projects/{id}/promptswrite

03Metrics

Current vs previous period KPIs and daily data points.

  • GET/projects/{id}/metricsread
  • GET/projects/{id}/metrics/timeseriesread

04Competitors

Competitor visibility ranking across AI models.

  • GET/projects/{id}/competitorsread

05Sources

Ranking of the domains AI answers cite most.

  • GET/projects/{id}/sourcesread

06Tags

Tags with prompt counts; create and apply new ones.

  • GET/projects/{id}/tagsread
  • POST/projects/{id}/tagswrite

07Fan-outs

Sub-queries AI models generated for your prompts.

  • GET/projects/{id}/fanoutsread
  • GET/projects/{id}/fanouts/detailsread

08Attribution

Self-reported attribution responses and summary.

  • GET/projects/{id}/attributionread
  • POST/projects/{id}/attributionwrite
  • GET/projects/{id}/attribution/summaryread
  • POST/projects/{id}/attribution/bulkwrite

09Tasks

AI-generated optimization tasks, sorted by priority.

  • GET/projects/{id}/tasksread
  • GET/projects/{id}/tasks/{taskId}read

10Export

All prompts with full results data in one call.

  • GET/projects/{id}/exportexport

AccountGET/me

Full reference with parameters and schemas

How it works

From any HTTP client to live AI visibility data.

Your code calls one REST endpoint. Bearer auth, JSON in, JSON out. Same backend as MCP.

Create an API key

Open API & MCP in the Finseo dashboard, choose scopes and optionally restrict the key to projects. It is shown only once.

app.finseo.ai/developer

API & MCP → Create API Key

readwriteexport

sk_live_… · read · write · export

app.finseo.ai/developer

API & MCP → Create API Key

readwriteexport

sk_live_… · read · write · export

List your projects

Every request sends the key as a Bearer token. The response lists the projects the key can access, each with its id.

curl https://api.finseo.ai/v1/projects \
  -H "Authorization: Bearer $FINSEO_API_KEY"
curl https://api.finseo.ai/v1/projects \
  -H "Authorization: Bearer $FINSEO_API_KEY"

Pull visibility data

Use the project id for metrics, competitors, sources and fan-outs. Filter by timeframe, model and tags like in the dashboard.

curl -G "https://api.finseo.ai/v1/projects/$PROJECT_ID/metrics" \
  -d timeframe=30d -d model=chatgpt \
  -H "Authorization: Bearer $FINSEO_API_KEY"
curl -G "https://api.finseo.ai/v1/projects/$PROJECT_ID/metrics" \
  -d timeframe=30d -d model=chatgpt \
  -H "Authorization: Bearer $FINSEO_API_KEY"

The AI visibility API

Build AI search analytics into anything you ship.

One REST API for AI search visibility, competitor tracking, source intelligence and AEO workflows. Pull data into your dashboards and stream everything to your warehouse.

Bearer · SHA-256 hashed

sk_live_•••••••8f2a

  • readPull metrics into dashboards
  • writeManage prompts and tags
  • exportStream to your warehouse

Enterprise-grade auth

Scoped keys you can lock to specific projects. SHA-256 hashed before storage and revocable in one click.

response.json · 200 OK

{
  "data": [ … ],
  "meta": { "page": 1, "limit": 50,
            "total": 128, "hasMore": true }
}

{ "error": { "code": "RATE_LIMIT_EXCEEDED", … } }

Predictable JSON, every time

Same data / meta / error envelope on every endpoint. Your client code stays simple as the surface area grows.

Rate limit headers

X-API-Version: v1
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 118
X-RateLimit-Reset: 1760104800

Built for production scale

Tuned for warehouse syncs, BI dashboards and real-time visibility checks. Custom quotas and dedicated capacity on enterprise.

Data flow

Every engine, one endpoint, your warehouse.

Languages & clients

Call the Finseo API from whatever you build with.

REST + JSON, Bearer auth, OpenAPI 3.0 spec. Works in every language and HTTP client.

One OpenAPI spec, every language

Generate clients with openapi-generator, oapi-codegen or stainless. Same Bearer auth across all SDKs.

View OpenAPI spec
curl

curl

CLI

Python

Python

Language

Node.js

Node.js

Runtime

TypeScript

TypeScript

Language

Go

Go

Language

Ruby

Ruby

Language

PHP

PHP

Language

Java

Java

Language

Postman

Postman

API client

Insomnia

Insomnia

API client

Bruno

Bruno

API client

OpenAPI

OpenAPI

Spec / SDKs

Common questions

Finseo REST API FAQ

What customers say

Rated 5.0 — and ready for your security review.

Single sign-on, roles per project and data hosted in Germany, with a data processing agreement for every organisation.

Christoph Sterkel

“With Finseo, we win in LLMs across every market. It’s how a brand like ours stays visible where it matters most.”

Christoph Sterkel

Head of Europe, Kellogg’s

OMR Reviews5.0/ 5G25.0/ 5

SSO via SAML

Login via your identity provider

Data in Germany

EU data residency, GDPR

Roles & audit trail

Every change logged

Book a demo

Build on the Finseo API

Get a personalized demo and see how teams ship dashboards, exports and AI ops on top of Finseo's REST API. You pick a slot in the next step.