List 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,
        "avgPosition": 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,
        "avgPosition": 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
    }
  }
}

Lists tracked prompts for a project with visibility, mention counts, and sentiment for the selected timeframe. Finseo evaluates these prompts against ChatGPT, Claude, Perplexity, and other models. avgPosition in the response is the Mention Depth: how deep in the answer text the brand mention appears (0% = very top). It is not a ranking position — for the ordinal Position KPI see the competitors endpoint (avgMentionOrder) and KPIs explained.

string

required

Project identifier.

string

default:"30d"

Rolling window length, e.g. 7d, 30d, 90d. This endpoint only supports relative windows — custom startDate/endDate ranges are not available here and are rejected with a 400.

string

Filter results to a single model (e.g. chatgpt).

string

ISO language code filter (e.g. en, de).

string

JSON array string or comma-separated tag names to filter prompts.

string

Case-insensitive substring match on prompt text.

integer

default:"1"

Page number (1-based).

integer

default:"50"

Page size (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,
        "avgPosition": 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
    }
  }
}

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Tasks

Export

Attribution