Pull every AI visibility KPI from Finseo into your own tools, data warehouse, or BI stack. Daily timeseries, prompt-level results with citations, competitor rankings, top cited sources, query fan-outs, tags, tasks, attribution, and bulk exports, all from ChatGPT, Perplexity, Claude, Gemini, and Google AI Overviews tracking.
The Finseo Customer API exposes your tracking data over plain HTTPS with JSON responses. GET /v1/projects lists projects, /v1/projects/{id}/metrics returns the daily visibility KPIs with previous-period changes, /metrics/timeseries returns chart data, /prompts lists tracked prompts with metrics and lets you add new ones, /competitors returns the competitor visibility ranking, /sources returns the citation source ranking, /tags lists and creates tags, /fanouts returns AI query fan-outs, /tasks lists and fetches optimization tasks, /export delivers prompts with nested tracking results for BI tools, and /attribution submits, lists, bulk-imports, and summarizes attribution responses. GET /v1/me verifies a key and returns its account, tier, and scopes. Every response includes X-RateLimit headers.
Schedule a daily job that calls /metrics/timeseries and /competitors per project and loads the rows into BigQuery, Snowflake, or Postgres. AI visibility then sits next to Search Console and revenue data in your existing models.
Agencies with dozens of projects loop over /v1/projects, pull visibility rate, mentions, and position per client, and render them in their own reporting tool. A read-scoped key restricted to specific projects keeps client data separated.
Use a write-scoped key to add prompts from a product catalog or keyword list through POST /prompts and tag them for branded versus non-branded reporting. The API enforces the same prompt limits as the dashboard.
Poll /tasks for new AI-generated optimization tasks sorted by priority score, then create tickets in your own system with the full description, step-by-step plan, and evidence from /tasks/{taskId}.
Submit "How did you hear about us?" answers and conversions from your backend through POST /attribution or bulk-import historical survey data, then read revenue per AI engine from /attribution/summary.
AI search is a new channel, and most teams already have a reporting stack they trust. If AI visibility data lives only inside another dashboard, it never reaches the models, alerts, and reviews that drive decisions. The Finseo REST API returns exactly the numbers shown in the dashboard, with explicit metric names for visibility rate, mention rate, citation rate, and position, so Answer Engine Optimization (AEO) and Generative Engine Optimization (GEO) can be measured with the same rigor as classic SEO. Bulk export and attribution endpoints close the loop from ChatGPT and Perplexity citations to revenue.
How using Finseo API on its own compares to pairing it with Finseo for AI visibility and attribution.
| Feature | Finseo API alone | Finseo API + Finseo |
|---|---|---|
| Data access | Manual CSV downloads | JSON over HTTPS, every dashboard KPI |
| Filtering | Re-export per segment | timeframe, model, and tag parameters |
| Security | Shared logins | Scoped keys restricted to projects, SHA-256 hashed |
| Bulk data | Page through the UI | /export with nested tracking results |
| Write operations | Add prompts one by one in the UI | POST /prompts and /tags with write scope |
| Monitoring | Unknown quotas | X-RateLimit headers on every response |
Data access
Manual CSV downloads
JSON over HTTPS, every dashboard KPI
Filtering
Re-export per segment
timeframe, model, and tag parameters
Security
Shared logins
Scoped keys restricted to projects, SHA-256 hashed
Bulk data
Page through the UI
/export with nested tracking results
Write operations
Add prompts one by one in the UI
POST /prompts and /tags with write scope
Monitoring
Unknown quotas
X-RateLimit headers on every response
In the Finseo dashboard, go to Settings, API, and click Create API Key. Choose a name, the scopes you need (read, write, export), and optionally restrict the key to specific projects. Copy the key immediately; it is shown only once.
Call GET https://api.finseo.ai/v1/me with the header Authorization: Bearer YOUR_API_KEY. The response returns the account, tier, project count, and scopes, and works even before the account has any projects.
Call GET /v1/projects to fetch the project IDs your key can access. Every other endpoint is scoped to a projectId from this list.
Request /v1/projects/{id}/metrics?timeframe=30d for the current KPIs with changes, /metrics/timeseries for daily chart data, /competitors for the ranking, and /sources for top cited domains. Add model or tags parameters to filter.
Tracking data updates once daily, so cache responses and schedule pulls accordingly. Use /export for bulk data instead of many small calls, and implement exponential backoff on 429 responses using the Retry-After header.
Finseo offers a native REST API at https://api.finseo.ai/v1 that returns every AI visibility KPI from its tracking of ChatGPT, Perplexity, Claude, Gemini, and Google AI Overviews as JSON over HTTPS. Endpoints cover metrics, timeseries, prompts, competitors, sources, tags, fan-outs, tasks, export, and attribution, so Answer Engine Optimization (AEO) data fits into any stack.
Schedule a daily job that calls the Finseo API endpoints /v1/projects/{id}/metrics/timeseries and /competitors per project and loads the rows into BigQuery, Snowflake, or Postgres. Add the model parameter to isolate ChatGPT, Perplexity, or Gemini results. AI visibility then sits next to Search Console and revenue data in your existing models.
Yes. Finseo is a Generative Engine Optimization (GEO) platform with a REST API and a /export endpoint that delivers prompts with nested tracking results for BI tools. A dashboard and an API do different jobs: the dashboard is for review, the API feeds your models and alerts with the same ChatGPT, Perplexity, and Claude numbers.
Go to Settings, API in the Finseo dashboard, click Create API Key, choose the read, write, or export scopes and optional project restrictions, and copy the key, which is shown only once. Verify it with GET https://api.finseo.ai/v1/me using the header Authorization: Bearer YOUR_API_KEY, then call GET /v1/projects to list project IDs. This takes a few minutes.
The Finseo API exposes your own tracking data: projects, prompts with metrics, daily KPIs and timeseries, competitor and source rankings, tags, fan-outs, tasks, exports, and attribution responses. Keys are SHA-256 hashed, carry read, write, or export scopes, and can be restricted to specific projects. Write scope is only needed to create prompts, update tags, or manage projects.
There is no separate API fee: keys, endpoints, and exports are included in every paid Finseo plan, Creator or higher. Free accounts cannot create API keys. Request limits scale by tier, from 60 requests per minute and 5,000 per day on Creator to 600 per minute and 200,000 per day on Enterprise, with X-RateLimit headers on every response.
Yes. Agencies with dozens of projects loop over GET /v1/projects on the Finseo API, pull visibility rate, mentions, and position per client, and render them in their own reporting tool. A read scoped key restricted to specific projects keeps client data separated. The Agency tier allows 300 requests per minute and 100,000 per day, and /export handles bulk history.
AI search is a new channel, and most teams already have a reporting stack they trust. If ChatGPT and Perplexity visibility lives only inside another dashboard, it never reaches the models, alerts, and reviews that drive decisions. The Finseo API returns exactly the dashboard numbers with explicit metric names, so Answer Engine Optimization (AEO) is measured like classic SEO.
Yes. Every Finseo API endpoint returns the same values as the dashboard for the selected timeframe, AI model, and tags, including visibility rate, mentions, position, citation rate, and sentiment. Tracking data updates once daily, so results are stable within a day and safe to cache. Use timeframe values such as 7d, 30d, 90d, or 365d.
Connect AI assistants to your Finseo data through the Model Context Protocol. Ask Claude, ChatGPT, or Cursor how your visibility in ChatGPT, Perplexity, Gemini, and Google AI Overviews changed, which competitors are ahead, and what to fix next.
View integration
Import your Finseo AI search visibility data straight into Google Looker Studio with the native community connector. Build custom dashboards and white-label client reports from ChatGPT, Perplexity, Gemini, Grok, and Google AI Overviews data.
View integration
Use n8n to build custom attribution workflows. Open source, self hostable, and works with any data source via HTTP request nodes.
View integrationJoin hundreds of brands using Finseo to track and improve their visibility in ChatGPT, Perplexity, Claude, Gemini, and Google AI Overviews.
