curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors?timeframe=30d&sortBy=mentions&limit=20' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params={"timeframe": "30d", "sortBy": "visibility", "limit": 20},
)
competitors = r.json()["data"]["competitors"]
print([c["name"] for c in competitors if c["isUserBrand"]])
{
"data": {
"competitors": [
{
"id": "c7d8e9f0-a1b2-4345-cdef-678901234abc",
"name": "Finseo",
"domain": "finseo.ai",
"baseDomain": "finseo.ai",
"isStarred": true,
"isUserBrand": true,
"totalMentions": 186,
"visibleResults": 214,
"totalResults": 420,
"visibilityRate": 51.0,
"visibilityChange": 4.2,
"visibilityIsMentionOnly": false,
"mentionRate": 44.3,
"mentionRateChange": 2.1,
"totalCitations": 98,
"citationRate": 23.3,
"citationRateChange": 3.8,
"avgMentionOrder": 2.3,
"avgMentionOrderChange": -0.2,
"firstMentionSharePercent": 44,
"top3MentionSharePercent": 65,
"shareOfVoicePercent": 8.2,
"shareOfVoiceChange": 0.6,
"averagePosition": 17.3,
"sentimentScore": 0.77,
"promptCount": 42
},
{
"id": "d8e9f0a1-b2c3-4456-def0-789012345bcd",
"name": "Competitor A",
"domain": "competitor-a.com",
"baseDomain": "competitor-a.com",
"isStarred": false,
"isUserBrand": false,
"totalMentions": 172,
"visibleResults": 181,
"totalResults": 420,
"visibilityRate": 43.1,
"visibilityChange": -1.4,
"visibilityIsMentionOnly": false,
"mentionRate": 41.0,
"mentionRateChange": -0.9,
"totalCitations": 24,
"citationRate": 5.7,
"citationRateChange": -0.5,
"avgMentionOrder": 3.1,
"avgMentionOrderChange": 0.4,
"firstMentionSharePercent": 23,
"top3MentionSharePercent": 53,
"shareOfVoicePercent": 4.2,
"shareOfVoiceChange": -0.3,
"averagePosition": 21.4,
"sentimentScore": 0.62,
"promptCount": 42
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 15,
"hasMore": false
}
}
}
Wettbewerber
Wettbewerber auflisten
GET
/
v1
/
projects
/
{projectId}
/
competitors
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors?timeframe=30d&sortBy=mentions&limit=20' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params={"timeframe": "30d", "sortBy": "visibility", "limit": 20},
)
competitors = r.json()["data"]["competitors"]
print([c["name"] for c in competitors if c["isUserBrand"]])
{
"data": {
"competitors": [
{
"id": "c7d8e9f0-a1b2-4345-cdef-678901234abc",
"name": "Finseo",
"domain": "finseo.ai",
"baseDomain": "finseo.ai",
"isStarred": true,
"isUserBrand": true,
"totalMentions": 186,
"visibleResults": 214,
"totalResults": 420,
"visibilityRate": 51.0,
"visibilityChange": 4.2,
"visibilityIsMentionOnly": false,
"mentionRate": 44.3,
"mentionRateChange": 2.1,
"totalCitations": 98,
"citationRate": 23.3,
"citationRateChange": 3.8,
"avgMentionOrder": 2.3,
"avgMentionOrderChange": -0.2,
"firstMentionSharePercent": 44,
"top3MentionSharePercent": 65,
"shareOfVoicePercent": 8.2,
"shareOfVoiceChange": 0.6,
"averagePosition": 17.3,
"sentimentScore": 0.77,
"promptCount": 42
},
{
"id": "d8e9f0a1-b2c3-4456-def0-789012345bcd",
"name": "Competitor A",
"domain": "competitor-a.com",
"baseDomain": "competitor-a.com",
"isStarred": false,
"isUserBrand": false,
"totalMentions": 172,
"visibleResults": 181,
"totalResults": 420,
"visibilityRate": 43.1,
"visibilityChange": -1.4,
"visibilityIsMentionOnly": false,
"mentionRate": 41.0,
"mentionRateChange": -0.9,
"totalCitations": 24,
"citationRate": 5.7,
"citationRateChange": -0.5,
"avgMentionOrder": 3.1,
"avgMentionOrderChange": 0.4,
"firstMentionSharePercent": 23,
"top3MentionSharePercent": 53,
"shareOfVoicePercent": 4.2,
"shareOfVoiceChange": -0.3,
"averagePosition": 21.4,
"sentimentScore": 0.62,
"promptCount": 42
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 15,
"hasMore": false
}
}
}
Gibt Wettbewerber nach KI-Sichtbarkeit gerankt zurück: Visibility, Mention Rate, Citation Rate, Mentions, Share of Voice, Position und Sentiment. So siehst du, wie sich Finseo gegen andere Brands in den Antworten von ChatGPT, Claude und Perplexity schlägt.
Pro Wettbewerber werden drei Präsenz-Raten zurückgegeben, alle als Anteil an
totalResults (siehe KPIs erklärt):
visibilityRate— Visibility: % der Antworten, in denen die Marke sichtbar ist, d. h. im Antworttext genannt ODER ihre Domain als Quelle zitiert (die „Visibility”-Spalte im Dashboard;visibleResultsist die Anzahl).visibilityIsMentionOnly: truekennzeichnet Zeilen, bei denen der Citation-Anteil nicht ermittelt werden konnte und der Wert der rein mention-basierten Rate entspricht.mentionRate— Mention Rate: % der Antworten, die die Marke im Text nennen (totalMentionsist die Anzahl).citationRate— Citation Rate: % der Antworten, die die Domain der Marke als Quelle zitieren (totalCitationsist die Anzahl);null, wenn die Citations für die Marke nicht ermittelt werden konnten.
mentionRate als auch in citationRate zählen, daher gilt visibilityRate ≤ mentionRate + citationRate.
Pro Wettbewerber werden zwei Positions-Metriken zurückgegeben:
avgMentionOrder— der ordinale Position-KPI: durchschnittlicher Rang unter allen in einer Antwort genannten Marken (1 = zuerst genannt, niedriger ist besser). Das ist der#2.3-Wert auf der Wettbewerber-Seite im Dashboard.averagePosition— Mention Depth: wie tief im Antworttext die Nennung erscheint (0 % = ganz oben). Keine Ranking-Position; der Name bleibt aus Kompatibilitätsgründen erhalten.
string
erforderlich
Projekt-ID.
string
Standard:"30d"
Analysezeitraum, z. B.
7d, 30d.string
Filtert die Tracking-Ergebnisse auf ein Modell.
string
Filtert Prompts nach Sprache.
string
JSON-Array oder kommaseparierte Prompt-Tags.
string
Filter nach Substring im Wettbewerber-Namen oder in der Domain.
string
Standard:"visibility"
Einer der Werte
visibility (genannt ODER zitiert), mentions, position, sentiment, name.string
Standard:"desc"
asc oder desc.integer
Standard:"1"
Seitennummer.
integer
Standard:"50"
Seitengröße (1–500).
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors?timeframe=30d&sortBy=mentions&limit=20' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params={"timeframe": "30d", "sortBy": "visibility", "limit": 20},
)
competitors = r.json()["data"]["competitors"]
print([c["name"] for c in competitors if c["isUserBrand"]])
{
"data": {
"competitors": [
{
"id": "c7d8e9f0-a1b2-4345-cdef-678901234abc",
"name": "Finseo",
"domain": "finseo.ai",
"baseDomain": "finseo.ai",
"isStarred": true,
"isUserBrand": true,
"totalMentions": 186,
"visibleResults": 214,
"totalResults": 420,
"visibilityRate": 51.0,
"visibilityChange": 4.2,
"visibilityIsMentionOnly": false,
"mentionRate": 44.3,
"mentionRateChange": 2.1,
"totalCitations": 98,
"citationRate": 23.3,
"citationRateChange": 3.8,
"avgMentionOrder": 2.3,
"avgMentionOrderChange": -0.2,
"firstMentionSharePercent": 44,
"top3MentionSharePercent": 65,
"shareOfVoicePercent": 8.2,
"shareOfVoiceChange": 0.6,
"averagePosition": 17.3,
"sentimentScore": 0.77,
"promptCount": 42
},
{
"id": "d8e9f0a1-b2c3-4456-def0-789012345bcd",
"name": "Competitor A",
"domain": "competitor-a.com",
"baseDomain": "competitor-a.com",
"isStarred": false,
"isUserBrand": false,
"totalMentions": 172,
"visibleResults": 181,
"totalResults": 420,
"visibilityRate": 43.1,
"visibilityChange": -1.4,
"visibilityIsMentionOnly": false,
"mentionRate": 41.0,
"mentionRateChange": -0.9,
"totalCitations": 24,
"citationRate": 5.7,
"citationRateChange": -0.5,
"avgMentionOrder": 3.1,
"avgMentionOrderChange": 0.4,
"firstMentionSharePercent": 23,
"top3MentionSharePercent": 53,
"shareOfVoicePercent": 4.2,
"shareOfVoiceChange": -0.3,
"averagePosition": 21.4,
"sentimentScore": 0.62,
"promptCount": 42
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 15,
"hasMore": false
}
}
}