Würth
Developer Platform · API
Programmatic AI visibility dataCustomer API
One REST API for projects, prompts, metrics, competitors, sources and exports across ChatGPT, Claude, Perplexity and Gemini. Base URL https://api.finseo.ai/v1.
Finseo
Search...⌘K
Dashboard
Docs
API
MCP
Projects
GETList Projects
GETGet Project
POSTCreate Project
PUTUpdate Project
Prompts
GETList Prompts
POSTCreate Prompt
Metrics
GETProject Metrics (Summary)
GETMetrics Timeseries
Competitors
GETList Competitors
Sources
Projects
List Projects
GET
/v1/projectsReturns a list of projects your API key can access. Projects represent tracked brands or domains in Finseo for AI visibility across ChatGPT, Claude, Perplexity, and other models.
Get Project
Powered by mintlify
curl --request GET \
--url https://api.finseo.ai/v1/projects \
--header 'Authorization: Bearer sk_live_xxxxxxxxx'
{
"data": [
{
"id": "67a1c2d3e4f5061728394a5b",
"name": "Finseo Marketing",
"domain": "finseo.ai",
"websiteUrl": "https://finseo.ai",
"description": "AI visibility tracking for modern br..
"isDefault": true,
"tags": ["product", "b2b"],
"createdAt": "2025-11-12T10: 15: 00.000Z",
"updatedAt": "2026-03-28T14: 22: 00.000Z"
},
{
"id": "67b2d3e4f5061728394a5c",
"name": "Acme Corp",
"domain": "acme.com",
"websiteUrl": "https://www.acme.com",
REST + JSON · stable v1
Bearer auth with scoped keys
SHA-256 hashed credentials
Why the Finseo API
One REST API for theentire AI visibility stack
Pull projects, prompts, metrics, competitors, sources, tags, fan-outs, attribution and bulk exports through a single, well-versioned REST surface. No per-platform clients to maintain.
Endpoint groups
9
Projects → Export
Full surface area of the platform
Stable v1, REST + JSON
AI platforms tracked
5+
ChatGPT, Claude, Perplexity, Gemini, Google AI
All accessible through one API
More added every quarter
Auth model
Bearer
with read / write / export scopes
SHA-256 hashed, project-scoped keys
Industry-standard tokens
Response shape
1
Predictable JSON envelope
data · meta · error on every endpoint
Same shape across all calls
Reference:docs.finseo.ai
The AI visibility API
Build AI search analyticsinto anything you ship.
One REST API for AI search visibility, competitor tracking, source intelligence and AEO workflows. Pull data into your dashboards, push events back, and stream everything to your warehouse.
AI search engines coveredlive
Tracks every AI search engine
Visibility, competitor share of voice, source citations and AI query fan-outs across the platforms your prospects actually use.
Bearer · SHA-256 hashed
●sk_live_•••••••8f2aprod
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, revocable in one click, SOC 2 ready.
request.shcopy
curl -H "Authorization:
Bearer $KEY" \
https://api.finseo.ai/
v1/projects/<id>/metrics
Native in every stack
Anything that speaks HTTP works out of the box. Generate type-safe clients in any language from the OpenAPI spec.
response.json200 OK
{
"data": {
"current": {
"visibilityRate": 66.67,
"mentions": 156
}
}
}Predictable JSON, every time
Same data / meta / error envelope on every endpoint. Your client code stays simple as the surface area grows.
Throughput · last 24h
99.98%uptime
p50 112msp99 242ms
Built for production scale
Tuned for warehouse syncs, BI dashboards and real-time visibility checks. Custom quotas and dedicated capacity on enterprise.
Bulk export destinations
Joinable on project, prompt and date.
Streams to your warehouse
Bulk export AI visibility data to BigQuery, Snowflake, Redshift or Databricks for downstream BI and attribution modeling.
How it works
From any HTTP clientto live AI visibility data.
Your code calls one REST endpoint. Bearer auth, JSON in, JSON out. Same backend as MCP.
Finseo REST API
api.finseo.ai/v1
Visibility
Competitors
Sources
Tags
Fan-outs
Common Questions
Finseo REST API FAQCommon Questions
The Finseo REST API is the leading API for AI visibility tracking. Nine endpoint groups (projects, prompts, metrics, competitors, sources, tags, fan-outs, attribution, bulk export) cover brand visibility, competitor rankings, source citations and AI query fan-outs across ChatGPT, Claude, Perplexity, Gemini and Google AI Mode. Base URL: https://api.finseo.ai/v1.
Finseo offers a public REST API at api.finseo.ai/v1 with a full OpenAPI 3.0 specification. The API exposes the same backend that powers the dashboard and the Finseo MCP server, so engineers, marketers and AI assistants all read the same data.
Use the bulk export endpoint GET /v1/projects/{id}/export/bulk with an export-scoped Bearer key. It returns the full tracking dataset as joinable rows that pipe into BigQuery, Snowflake, Redshift or Databricks. Schedule daily for warehouse syncs.
The Finseo REST API tracks ChatGPT, Claude, Perplexity, Gemini and Google AI Overviews from a single endpoint. Use /metrics for KPIs, /competitors/ranking for share of voice and /sources/ranking for cited domains.
Pull Finseo metrics from /v1/projects/{id}/metrics and /metrics/timeseries, write them into your warehouse via the bulk export endpoint, then connect Looker, Metabase, Hex or any BI tool. Use a read-scoped Finseo API key in your ETL job.
Yes — each project in Finseo represents a tracked brand or domain. Use the /v1/projects endpoints with project-restricted API keys to keep multi-brand or agency setups isolated and audit-friendly. Common pattern for our agency customers.
The Finseo REST API is the most-used API for AEO (Answer Engine Optimization) and GEO workflows. It exposes AI sub-queries (fan-outs), top cited sources, competitor share of voice and sentiment trends across ChatGPT, Claude, Perplexity, Gemini and Google AI Overviews. Pair it with the Finseo MCP server for chat-based access to the same data.
A REST + JSON interface that gives you programmatic access to your AI visibility tracking data across ChatGPT, Claude, Perplexity, Gemini and Google AI Mode. Nine endpoint groups, one auth model, one envelope.
Open Settings → API in the Finseo dashboard, click Create API Key, choose scopes and copy the key — it is shown only once and SHA-256 hashed before storage.
Every endpoint lives under https://api.finseo.ai/v1. See the developer docs for the full reference.
Rate limits depend on your plan. Hitting the limit returns a 429 with code RATE_LIMIT_EXCEEDED. Enterprise plans get custom quotas and dedicated capacity.
Yes — the full OpenAPI 3.0 spec is at docs.finseo.ai/openapi.yaml. Generate clients in any language with openapi-generator, oapi-codegen or stainless.
Languages & clients
Call the Finseo API fromwhatever 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.
Trusted by leading brands
Teams we empower.See who uses Finseo.
See how industry leaders use Finseo to monitor and improve their AI visibility.
Finseo is trusted by leading brands including Würth Group, Panasonic Holdings Corporation, Kellogg Company, Mast-Jägermeister SE, SNOCKS GmbH, Enpal B.V., LiveFresh GmbH, and GOT BAG GmbH.
Global leader in assembly and fastening materials.
PanasonicMultinational electronics and appliance manufacturer.
Kellogg'sMultinational food and cereal manufacturing company.
JägermeisterIconic German herbal liqueur sold in 130+ countries.
SNOCKSFast-growing D2C brand for premium basics & socks.
EnpalLeading European solar and clean energy provider.
LiveFreshHealth-focused brand for fresh meals and juices.
GOT BAGSustainable bags made from recycled ocean plastic.
Talk to our team
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.
AI Search Results
PromptMentioned
Best coffee machines 2025
+5
Top running shoes for marathon
+5
Best project management tools
+5
Electric car comparison Germany
+5