Wettbewerber auflisten

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors?timeframe=30d&sortBy=mentions&limit=20' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

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": 412,
        "visibleResults": 186,
        "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": 389,
        "visibleResults": 172,
        "averagePosition": 21.4,
        "sentimentScore": 0.62,
        "promptCount": 42
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 15,
      "hasMore": false
    }
  }
}

GET

projects

{projectId}

competitors

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors?timeframe=30d&sortBy=mentions&limit=20' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

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": 412,
        "visibleResults": 186,
        "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": 389,
        "visibleResults": 172,
        "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: Mentions, Sichtbarkeit, durchschnittliche Position und Sentiment. So siehst du, wie sich Finseo gegen andere Brands in den Antworten von ChatGPT, Claude und Perplexity schlägt.

projectId

string

erforderlich

Projekt-ID.

timeframe

string

Standard:"30d"

Analysezeitraum, z. B. 7d, 30d.

model

string

Filtert die Tracking-Ergebnisse auf ein Modell.

language

string

Filtert Prompts nach Sprache.

tags

string

JSON-Array oder kommaseparierte Prompt-Tags.

string

Filter nach Substring im Wettbewerber-Namen oder in der Domain.

sortBy

string

Standard:"mentions"

Einer der Werte visibility, mentions, position, sentiment, name.

sortDir

string

Standard:"desc"

asc oder desc.

page

integer

Standard:"1"

Seitennummer.

limit

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 sk_live_xxxxxxxx'

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": 412,
        "visibleResults": 186,
        "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": 389,
        "visibleResults": 172,
        "averagePosition": 21.4,
        "sentimentScore": 0.62,
        "promptCount": 42
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 15,
      "hasMore": false
    }
  }
}

Metriken-Zeitreihe Quellen auflisten

Projekte

Prompts

Metriken

Wettbewerber

Quellen

Tags

Fan-outs

Export

Attribution

Wettbewerber auflisten