curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts?timeframe=30d&limit=10&page=1' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
params = {"timeframe": "30d", "limit": 10, "page": 1, "search": "Finseo"}
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params=params,
)
body = r.json()["data"]
first = body["prompts"][0]
print(body["totalCount"], first["prompt"], first["mentionRate"], first["citationRate"])
{
"data": {
"prompts": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"prompt": "What are the best AI SEO tools including Finseo?",
"domain": "finseo.ai",
"brandName": "finseo",
"language": "en",
"tags": ["branded", "comparison"],
"models": ["chatgpt", "claude", "perplexity"],
"createdAt": "2026-02-10T12:00:00.000Z",
"updatedAt": "2026-09-01T08:00:00.000Z",
"lastCheckedAt": "2026-09-08T06:12:00.000Z",
"isVisible": true,
"totalMentions": 14,
"mentionRate": 46.7,
"avgPosition": 18.2,
"sentimentScore": 76,
"resultCount": 30,
"competitorCount": 6,
"sourceCount": 22,
"ownDomainCitations": 9,
"ownDomainCitationsChange": 3,
"citationRate": 30.0,
"mentionsChange": 2,
"sentimentChange": 4,
"positionChange": -1.5,
"visibilityChange": 6,
"topCompetitors": [
{ "brandName": "Competitor A", "domain": "competitor-a.com", "mentions": 11, "isUserBrand": false }
]
}
],
"totalCount": 48,
"currentPage": 1,
"totalPages": 5,
"hasMore": true
}
}
Prompts
Prompts auflisten
GET
/
v1
/
projects
/
{projectId}
/
prompts
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts?timeframe=30d&limit=10&page=1' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
params = {"timeframe": "30d", "limit": 10, "page": 1, "search": "Finseo"}
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params=params,
)
body = r.json()["data"]
first = body["prompts"][0]
print(body["totalCount"], first["prompt"], first["mentionRate"], first["citationRate"])
{
"data": {
"prompts": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"prompt": "What are the best AI SEO tools including Finseo?",
"domain": "finseo.ai",
"brandName": "finseo",
"language": "en",
"tags": ["branded", "comparison"],
"models": ["chatgpt", "claude", "perplexity"],
"createdAt": "2026-02-10T12:00:00.000Z",
"updatedAt": "2026-09-01T08:00:00.000Z",
"lastCheckedAt": "2026-09-08T06:12:00.000Z",
"isVisible": true,
"totalMentions": 14,
"mentionRate": 46.7,
"avgPosition": 18.2,
"sentimentScore": 76,
"resultCount": 30,
"competitorCount": 6,
"sourceCount": 22,
"ownDomainCitations": 9,
"ownDomainCitationsChange": 3,
"citationRate": 30.0,
"mentionsChange": 2,
"sentimentChange": 4,
"positionChange": -1.5,
"visibilityChange": 6,
"topCompetitors": [
{ "brandName": "Competitor A", "domain": "competitor-a.com", "mentions": 11, "isUserBrand": false }
]
}
],
"totalCount": 48,
"currentPage": 1,
"totalPages": 5,
"hasMore": true
}
}
Listet die getrackten Prompts eines Projekts auf — mit Sichtbarkeit, Mention-Zahlen, Citations und Sentiment für den gewählten Zeitraum. Finseo wertet diese Prompts gegen ChatGPT, Claude, Perplexity und weitere Modelle aus.
Pro Prompt beziehen sich alle Zahlen auf die KI-Antworten des gewählten Zeitraums (
resultCount; siehe KPIs erklärt):
isVisible— die Marke war in mindestens einer Antwort sichtbar: im Antworttext genannt ODER die eigene Domain als Quelle zitierttotalMentions/mentionRate— Antworten, die die Marke im Text nennen, und diese Anzahl in % vonresultCount(Mention Rate)ownDomainCitations/citationRate— Antworten, die die eigene Domain (oder einen konfigurierten Domain-Alias) als Quelle zitieren, und diese Anzahl in % vonresultCount(Citation Rate)
string
erforderlich
Projekt-ID.
string
Standard:"30d"
Länge des rollierenden Zeitfensters, z. B.
7d, 30d, 90d.string
Filtert die Ergebnisse auf ein einzelnes Modell (z. B.
chatgpt).string
Filter nach ISO-Sprachcode (z. B.
en, de).string
JSON-Array als String oder kommaseparierte Tag-Namen, um Prompts zu filtern.
string
Case-insensitive Substring-Suche im Prompt-Text.
integer
Standard:"1"
Seitennummer (beginnend bei 1).
integer
Standard:"50"
Seitengröße (1–500).
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts?timeframe=30d&limit=10&page=1' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
params = {"timeframe": "30d", "limit": 10, "page": 1, "search": "Finseo"}
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params=params,
)
body = r.json()["data"]
first = body["prompts"][0]
print(body["totalCount"], first["prompt"], first["mentionRate"], first["citationRate"])
{
"data": {
"prompts": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"prompt": "What are the best AI SEO tools including Finseo?",
"domain": "finseo.ai",
"brandName": "finseo",
"language": "en",
"tags": ["branded", "comparison"],
"models": ["chatgpt", "claude", "perplexity"],
"createdAt": "2026-02-10T12:00:00.000Z",
"updatedAt": "2026-09-01T08:00:00.000Z",
"lastCheckedAt": "2026-09-08T06:12:00.000Z",
"isVisible": true,
"totalMentions": 14,
"mentionRate": 46.7,
"avgPosition": 18.2,
"sentimentScore": 76,
"resultCount": 30,
"competitorCount": 6,
"sourceCount": 22,
"ownDomainCitations": 9,
"ownDomainCitationsChange": 3,
"citationRate": 30.0,
"mentionsChange": 2,
"sentimentChange": 4,
"positionChange": -1.5,
"visibilityChange": 6,
"topCompetitors": [
{ "brandName": "Competitor A", "domain": "competitor-a.com", "mentions": 11, "isUserBrand": false }
]
}
],
"totalCount": 48,
"currentPage": 1,
"totalPages": 5,
"hasMore": true
}
}