Entwicklerplattform · API

Die AI Visibility API für programmatische AEO- & GEO-Daten

Eine REST-API für Projekte, Prompts, Metriken, Wettbewerber, Quellen und Exporte über ChatGPT, Claude, Perplexity und Gemini. Basis-URL https://api.finseo.ai/v1.

API-Key holenDoku lesen
  • REST + JSON · stabile v1
  • Bearer-Auth mit Scoped Keys
  • SHA-256-gehashte Credentials
curl https://api.finseo.ai/v1/projects \
  --header "Authorization: Bearer sk_live_…"

500+ ambitionierte Teams gewinnen die KI-Such-Ära.

Für MarkenFür Agenturen
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

Gewinnt in LLMs

über alle Märkte

Warum die Finseo-API

Eine REST-API für die ganze KI-Sichtbarkeit.

Hol Projekte, Prompts, Metriken, Wettbewerber, Quellen, Tags, Fan-outs, Attribution, Aufgaben und Bulk-Exporte über eine einzige, sauber versionierte REST-Oberfläche. Keine Clients pro Plattform zu pflegen.

  • 10

    Endpoint-Gruppen

    Projekte → Export

    Gesamte Oberfläche der Plattform

  • 5+

    Getrackte KI-Plattformen

    ChatGPT, Claude, Perplexity, Gemini, Google AI

    Alle über eine API erreichbar

  • Bearer

    Auth-Modell

    mit read / write / export Scopes

    SHA-256-gehasht, projektbezogene Keys

  • 1

    Response-Form

    Berechenbares JSON-Envelope

    data · meta · error auf jedem Endpoint

Endpoints

Zehn Endpoint-Gruppen, eine Basis-URL.

Jeder Pfad unten liegt unter https://api.finseo.ai/v1 und liefert dasselbe JSON-Envelope. Der Scope neben jeder Route ist der, den der Key braucht.

01Projects

Getrackte Marken und Domains, auf die dein Key zugreift.

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

02Prompts

Getrackte Prompts mit Sichtbarkeits-Metriken, und neue zum Tracken.

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

03Metrics

KPIs im Vergleich zur Vorperiode und tägliche Datenpunkte.

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

04Competitors

Wettbewerber-Ranking nach Sichtbarkeit über alle KI-Modelle.

  • GET/projects/{id}/competitorsread

05Sources

Ranking der Domains, die KI-Antworten am häufigsten zitieren.

  • GET/projects/{id}/sourcesread

06Tags

Tags mit Prompt-Anzahl; neue anlegen und zuweisen.

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

07Fan-outs

Sub-Queries, die KI-Modelle für deine Prompts erzeugt haben.

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

08Attribution

Selbst angegebene Attributions-Antworten und Zusammenfassung.

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

09Tasks

KI-generierte Optimierungsaufgaben, nach Priorität sortiert.

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

10Export

Alle Prompts mit vollständigen Ergebnisdaten in einem Call.

  • GET/projects/{id}/exportexport

AccountGET/me

Vollständige Referenz mit Parametern und Schemas

So funktioniert's

Von jedem HTTP-Client zu Live-KI-Sichtbarkeit.

Dein Code ruft einen REST-Endpoint auf. Bearer-Auth, JSON rein, JSON raus. Gleiches Backend wie MCP.

API-Key erstellen

Öffne API & MCP im Finseo-Dashboard, wähle Scopes und beschränke den Key optional auf Projekte. Er wird nur einmal angezeigt.

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

Projekte abrufen

Jede Anfrage schickt den Key als Bearer-Token. Die Antwort listet die Projekte, auf die der Key zugreifen darf, jeweils mit 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"

Sichtbarkeitsdaten holen

Mit der Projekt-ID holst du Metriken, Wettbewerber, Quellen und Fan-outs. Filter nach Zeitraum, Modell und Tags wie im 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"

Die KI-Sichtbarkeits-API

Bau KI-Suchanalysen in alles ein, was du auslieferst.

Eine REST-API für KI-Such-Sichtbarkeit, Wettbewerber-Tracking, Quellen-Intelligence und AEO-Workflows. Hol Daten in deine Dashboards und streame alles in dein Warehouse.

Bearer · SHA-256-gehasht

sk_live_•••••••8f2a

  • readMetriken in Dashboards holen
  • writePrompts und Tags verwalten
  • exportIns Warehouse streamen

Enterprise-Grade-Auth

Scoped Keys, die du auf bestimmte Projekte beschränkst. SHA-256-gehasht vor der Speicherung und in einem Klick widerrufbar.

response.json · 200 OK

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

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

Berechenbares JSON, jedes Mal

Gleiches data/meta/error-Envelope auf jedem Endpoint. Dein Client-Code bleibt simpel, auch wenn die Surface wächst.

Rate-Limit-Header

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

Für Produktions-Scale gebaut

Optimiert für Warehouse-Syncs, BI-Dashboards und Echtzeit-Sichtbarkeits-Checks. Custom Quotas und dedizierte Kapazität im Enterprise.

Datenfluss

Jede Engine, ein Endpoint, dein Warehouse.

Sprachen & Clients

Nutz die Finseo-API in allem, was du baust.

REST + JSON, Bearer-Auth, OpenAPI-3.0-Spec. Läuft in jeder Sprache und jedem HTTP-Client.

Eine OpenAPI-Spec, jede Sprache

Generiere Clients mit openapi-generator, oapi-codegen oder stainless. Gleiche Bearer-Auth über alle SDKs.

OpenAPI-Spec ansehen
curl

curl

CLI

Python

Python

Sprache

Node.js

Node.js

Runtime

TypeScript

TypeScript

Sprache

Go

Go

Sprache

Ruby

Ruby

Sprache

PHP

PHP

Sprache

Java

Java

Sprache

Postman

Postman

API-Client

Insomnia

Insomnia

API-Client

Bruno

Bruno

API-Client

OpenAPI

OpenAPI

Spec / SDKs

Häufige Fragen

Finseo REST API FAQ

Was Kunden sagen

Mit 5,0 bewertet — und bereit für euren Security-Check.

Single Sign-on, Rollen pro Projekt und Hosting in Deutschland, mit Auftragsverarbeitungsvertrag für jede Organisation.

Christoph Sterkel

„Mit Finseo gewinnen wir in LLMs auf jedem Markt. So bleibt eine Marke wie unsere dort sichtbar, wo es zählt.“

Christoph Sterkel

Head of Europe, Kellogg’s

OMR Reviews5,0/ 5G25,0/ 5

SSO via SAML

Login über deinen Identity Provider

Daten in Deutschland

EU-Datenhaltung, DSGVO

Rollen & Audit-Trail

Jede Änderung protokolliert

Demo buchen

Bau auf der Finseo-API

In einer persönlichen Demo zeigen wir dir, wie Teams Dashboards, Exporte und KI-Workflows auf der REST-API von Finseo bauen. Im nächsten Schritt wählst du einen Termin.