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
Lister les 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
}
}
Liste les prompts suivis d’un projet avec la visibilité, le nombre de Mentions, les citations et le Sentiment pour la période sélectionnée. Finseo évalue ces prompts sur ChatGPT, Claude, Perplexity et d’autres modèles.
Par prompt, tous les décomptes se rapportent aux réponses IA de la période sélectionnée (
resultCount ; voir KPIs expliqués) :
isVisible— la marque a été visible dans au moins une réponse : nommée dans le texte de la réponse OU le domaine propre cité comme sourcetotalMentions/mentionRate— réponses nommant la marque dans le texte, et ce décompte en % deresultCount(Mention Rate)ownDomainCitations/citationRate— réponses citant le domaine propre (ou un alias de domaine configuré) comme source, et ce décompte en % deresultCount(Citation Rate)
string
requis
Identifiant du projet.
string
défaut:"30d"
Durée de la fenêtre glissante, p. ex.
7d, 30d, 90d.string
Filtre les résultats sur un seul modèle (p. ex.
chatgpt).string
Filtre par code de langue ISO (p. ex.
en, de).string
Chaîne au format tableau JSON ou noms de Tags séparés par des virgules pour filtrer les prompts.
string
Correspondance de sous-chaîne insensible à la casse sur le texte du prompt.
integer
défaut:"1"
Numéro de page (à partir de 1).
integer
défaut:"50"
Taille de page (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
}
}