Prompts auflisten

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts?timeframe=30d&limit=10&page=1' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

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"]
print(body["pagination"], body["prompts"][0]["prompt"])

{
  "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"],
        "intentScores": { "commercial": 0.82, "informational": 0.64 },
        "searchIntents": ["compare", "evaluate"],
        "isVisible": true,
        "mentions": 14,
        "averagePosition": 18.2,
        "sentimentScore": 0.76,
        "sentimentCategory": "positive",
        "competitorCount": 6,
        "sourceCount": 22,
        "createdAt": "2026-02-10T12:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 48,
      "hasMore": true
    }
  }
}

GET

projects

{projectId}

prompts

curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts?timeframe=30d&limit=10&page=1' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

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"]
print(body["pagination"], body["prompts"][0]["prompt"])

{
  "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"],
        "intentScores": { "commercial": 0.82, "informational": 0.64 },
        "searchIntents": ["compare", "evaluate"],
        "isVisible": true,
        "mentions": 14,
        "averagePosition": 18.2,
        "sentimentScore": 0.76,
        "sentimentCategory": "positive",
        "competitorCount": 6,
        "sourceCount": 22,
        "createdAt": "2026-02-10T12:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 48,
      "hasMore": true
    }
  }
}

Listet die getrackten Prompts eines Projekts auf — mit Sichtbarkeit, Mention-Zahlen und Sentiment für den gewählten Zeitraum. Finseo wertet diese Prompts gegen ChatGPT, Claude, Perplexity und weitere Modelle aus.

projectId

string

erforderlich

Projekt-ID.

timeframe

string

Standard:"30d"

Länge des rollierenden Zeitfensters, z. B. 7d, 30d, 90d.

model

string

Filtert die Ergebnisse auf ein einzelnes Modell (z. B. chatgpt).

language

string

Filter nach ISO-Sprachcode (z. B. en, de).

tags

string

JSON-Array als String oder kommaseparierte Tag-Namen, um Prompts zu filtern.

string

Case-insensitive Substring-Suche im Prompt-Text.

page

integer

Standard:"1"

Seitennummer (beginnend bei 1).

limit

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

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"]
print(body["pagination"], body["prompts"][0]["prompt"])

{
  "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"],
        "intentScores": { "commercial": 0.82, "informational": 0.64 },
        "searchIntents": ["compare", "evaluate"],
        "isVisible": true,
        "mentions": 14,
        "averagePosition": 18.2,
        "sentimentScore": 0.76,
        "sentimentCategory": "positive",
        "competitorCount": 6,
        "sourceCount": 22,
        "createdAt": "2026-02-10T12:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 48,
      "hasMore": true
    }
  }
}

Projekt aktualisieren Prompt erstellen

Projekte

Prompts

Metriken

Wettbewerber

Quellen

Tags

Fan-outs

Export

Attribution

Prompts auflisten