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

{
  "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
    }
  }
}
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.
​
projectId
string
required
Project identifier.
​
timeframe
string
default:"30d"
Rolling window length, e.g. 7d, 30d, 90d.
​
model
string
Filter results to a single model (e.g. chatgpt).
​
language
string
ISO language code filter (e.g. en, de).
​
tags
string
JSON array string or comma-separated tag names to filter prompts.
​
search
string
Case-insensitive substring match on prompt text.
​
page
integer
default:"1"
Page number (1-based).
​
limit
integer
default:"50"
Page size (1–500).
curl --request GET \
  --url 'https://app.finseo.ai/api/v1/projects/67a1c2d3e4f5061728394a5b/prompts?timeframe=30d&limit=10&page=1' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

{
  "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
    }
  }
}