curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts?timeframe=30d&limit=10&page=1' \
--header "Authorization: Bearer $FINSEO_API_KEY"
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"]
first = body["prompts"][0]
print(body["totalCount"], first["prompt"], first["mentionRate"], first["citationRate"])
{
"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"],
"createdAt": "2026-02-10T12:00:00.000Z",
"updatedAt": "2026-09-01T08:00:00.000Z",
"lastCheckedAt": "2026-09-08T06:12:00.000Z",
"isVisible": true,
"totalMentions": 14,
"mentionRate": 46.7,
"avgPosition": 18.2,
"sentimentScore": 76,
"resultCount": 30,
"competitorCount": 6,
"sourceCount": 22,
"ownDomainCitations": 9,
"ownDomainCitationsChange": 3,
"citationRate": 30.0,
"mentionsChange": 2,
"sentimentChange": 4,
"positionChange": -1.5,
"visibilityChange": 6,
"topCompetitors": [
{ "brandName": "Competitor A", "domain": "competitor-a.com", "mentions": 11, "isUserBrand": false }
]
}
],
"totalCount": 48,
"currentPage": 1,
"totalPages": 5,
"hasMore": true
}
}
Prompts
List Prompts
GET
/
v1
/
projects
/
{projectId}
/
prompts
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/prompts?timeframe=30d&limit=10&page=1' \
--header "Authorization: Bearer $FINSEO_API_KEY"
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"]
first = body["prompts"][0]
print(body["totalCount"], first["prompt"], first["mentionRate"], first["citationRate"])
{
"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"],
"createdAt": "2026-02-10T12:00:00.000Z",
"updatedAt": "2026-09-01T08:00:00.000Z",
"lastCheckedAt": "2026-09-08T06:12:00.000Z",
"isVisible": true,
"totalMentions": 14,
"mentionRate": 46.7,
"avgPosition": 18.2,
"sentimentScore": 76,
"resultCount": 30,
"competitorCount": 6,
"sourceCount": 22,
"ownDomainCitations": 9,
"ownDomainCitationsChange": 3,
"citationRate": 30.0,
"mentionsChange": 2,
"sentimentChange": 4,
"positionChange": -1.5,
"visibilityChange": 6,
"topCompetitors": [
{ "brandName": "Competitor A", "domain": "competitor-a.com", "mentions": 11, "isUserBrand": false }
]
}
],
"totalCount": 48,
"currentPage": 1,
"totalPages": 5,
"hasMore": true
}
}
Lists tracked prompts for a project with visibility, mention counts, citations, and sentiment for the selected timeframe. Finseo evaluates these prompts against ChatGPT, Claude, Perplexity, and other models.
Per prompt, all counts refer to the AI answers of the selected timeframe (
resultCount; see KPIs explained):
isVisible— the brand was visible in at least one answer: named in the answer text OR the own domain cited as a sourcetotalMentions/mentionRate— answers naming the brand in the text, and that count as a % ofresultCount(Mention Rate)ownDomainCitations/citationRate— answers citing the own domain (or a configured domain alias) as a source, and that count as a % ofresultCount(Citation Rate)
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 $FINSEO_API_KEY"
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"]
first = body["prompts"][0]
print(body["totalCount"], first["prompt"], first["mentionRate"], first["citationRate"])
{
"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"],
"createdAt": "2026-02-10T12:00:00.000Z",
"updatedAt": "2026-09-01T08:00:00.000Z",
"lastCheckedAt": "2026-09-08T06:12:00.000Z",
"isVisible": true,
"totalMentions": 14,
"mentionRate": 46.7,
"avgPosition": 18.2,
"sentimentScore": 76,
"resultCount": 30,
"competitorCount": 6,
"sourceCount": 22,
"ownDomainCitations": 9,
"ownDomainCitationsChange": 3,
"citationRate": 30.0,
"mentionsChange": 2,
"sentimentChange": 4,
"positionChange": -1.5,
"visibilityChange": 6,
"topCompetitors": [
{ "brandName": "Competitor A", "domain": "competitor-a.com", "mentions": 11, "isUserBrand": false }
]
}
],
"totalCount": 48,
"currentPage": 1,
"totalPages": 5,
"hasMore": true
}
}