curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors?timeframe=30d&sortBy=mentions&limit=20' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params={"timeframe": "30d", "sortBy": "visibility", "limit": 20},
)
competitors = r.json()["data"]["competitors"]
print([c["name"] for c in competitors if c["isUserBrand"]])
{
"data": {
"competitors": [
{
"id": "c7d8e9f0-a1b2-4345-cdef-678901234abc",
"name": "Finseo",
"domain": "finseo.ai",
"baseDomain": "finseo.ai",
"isStarred": true,
"isUserBrand": true,
"totalMentions": 186,
"visibleResults": 214,
"totalResults": 420,
"visibilityRate": 51.0,
"visibilityChange": 4.2,
"visibilityIsMentionOnly": false,
"mentionRate": 44.3,
"mentionRateChange": 2.1,
"totalCitations": 98,
"citationRate": 23.3,
"citationRateChange": 3.8,
"averagePosition": 17.3,
"sentimentScore": 0.77,
"promptCount": 42
},
{
"id": "d8e9f0a1-b2c3-4456-def0-789012345bcd",
"name": "Competitor A",
"domain": "competitor-a.com",
"baseDomain": "competitor-a.com",
"isStarred": false,
"isUserBrand": false,
"totalMentions": 172,
"visibleResults": 181,
"totalResults": 420,
"visibilityRate": 43.1,
"visibilityChange": -1.4,
"visibilityIsMentionOnly": false,
"mentionRate": 41.0,
"mentionRateChange": -0.9,
"totalCitations": 24,
"citationRate": 5.7,
"citationRateChange": -0.5,
"averagePosition": 21.4,
"sentimentScore": 0.62,
"promptCount": 42
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 15,
"hasMore": false
}
}
}
Competitors
Lister les concurrents
GET
/
v1
/
projects
/
{projectId}
/
competitors
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors?timeframe=30d&sortBy=mentions&limit=20' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params={"timeframe": "30d", "sortBy": "visibility", "limit": 20},
)
competitors = r.json()["data"]["competitors"]
print([c["name"] for c in competitors if c["isUserBrand"]])
{
"data": {
"competitors": [
{
"id": "c7d8e9f0-a1b2-4345-cdef-678901234abc",
"name": "Finseo",
"domain": "finseo.ai",
"baseDomain": "finseo.ai",
"isStarred": true,
"isUserBrand": true,
"totalMentions": 186,
"visibleResults": 214,
"totalResults": 420,
"visibilityRate": 51.0,
"visibilityChange": 4.2,
"visibilityIsMentionOnly": false,
"mentionRate": 44.3,
"mentionRateChange": 2.1,
"totalCitations": 98,
"citationRate": 23.3,
"citationRateChange": 3.8,
"averagePosition": 17.3,
"sentimentScore": 0.77,
"promptCount": 42
},
{
"id": "d8e9f0a1-b2c3-4456-def0-789012345bcd",
"name": "Competitor A",
"domain": "competitor-a.com",
"baseDomain": "competitor-a.com",
"isStarred": false,
"isUserBrand": false,
"totalMentions": 172,
"visibleResults": 181,
"totalResults": 420,
"visibilityRate": 43.1,
"visibilityChange": -1.4,
"visibilityIsMentionOnly": false,
"mentionRate": 41.0,
"mentionRateChange": -0.9,
"totalCitations": 24,
"citationRate": 5.7,
"citationRateChange": -0.5,
"averagePosition": 21.4,
"sentimentScore": 0.62,
"promptCount": 42
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 15,
"hasMore": false
}
}
}
Renvoie le classement des concurrents en matière de visibilité IA : visibilité, mention rate, citation rate, Mentions, Share of Voice, position et Sentiment. Utilisez cet Endpoint pour voir comment Finseo se positionne face aux autres marques dans les réponses de ChatGPT, Claude et Perplexity.
Trois taux de présence sont renvoyés par concurrent, tous exprimés en part de
totalResults (voir KPIs expliqués) :
visibilityRate— Visibility : % de réponses dans lesquelles la marque est visible, c.-à-d. nommée dans le texte de la réponse OU son domaine cité comme source (la colonne « Visibility » du dashboard ;visibleResultsest le décompte).visibilityIsMentionOnly: truesignale les lignes pour lesquelles le volet citations n’a pas pu être résolu et où la valeur est égale au taux basé sur les mentions.mentionRate— Mention Rate : % de réponses nommant la marque dans le texte (totalMentionsest le décompte).citationRate— Citation Rate : % de réponses citant le domaine de la marque comme source (totalCitationsest le décompte) ;nulllorsque les citations n’ont pas pu être résolues pour la marque.
mentionRate et citationRate, donc visibilityRate ≤ mentionRate + citationRate.
string
requis
Identifiant du projet.
string
défaut:"30d"
Fenêtre d’analyse, p. ex.
7d, 30d.string
Filtre les résultats de Tracking sur un seul modèle.
string
Filtre les prompts par langue.
string
Tableau JSON ou Tags de prompts séparés par des virgules.
string
Filtre par sous-chaîne du nom ou du domaine du concurrent.
string
défaut:"visibility"
L’une des valeurs
visibility (nommée OU citée), mentions, position, sentiment, name.string
défaut:"desc"
asc ou desc.integer
défaut:"1"
Numéro de page.
integer
défaut:"50"
Taille de page (1–500).
curl --request GET \
--url 'https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors?timeframe=30d&sortBy=mentions&limit=20' \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
r = requests.get(
"https://api.finseo.ai/v1/projects/67a1c2d3e4f5061728394a5b/competitors",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
params={"timeframe": "30d", "sortBy": "visibility", "limit": 20},
)
competitors = r.json()["data"]["competitors"]
print([c["name"] for c in competitors if c["isUserBrand"]])
{
"data": {
"competitors": [
{
"id": "c7d8e9f0-a1b2-4345-cdef-678901234abc",
"name": "Finseo",
"domain": "finseo.ai",
"baseDomain": "finseo.ai",
"isStarred": true,
"isUserBrand": true,
"totalMentions": 186,
"visibleResults": 214,
"totalResults": 420,
"visibilityRate": 51.0,
"visibilityChange": 4.2,
"visibilityIsMentionOnly": false,
"mentionRate": 44.3,
"mentionRateChange": 2.1,
"totalCitations": 98,
"citationRate": 23.3,
"citationRateChange": 3.8,
"averagePosition": 17.3,
"sentimentScore": 0.77,
"promptCount": 42
},
{
"id": "d8e9f0a1-b2c3-4456-def0-789012345bcd",
"name": "Competitor A",
"domain": "competitor-a.com",
"baseDomain": "competitor-a.com",
"isStarred": false,
"isUserBrand": false,
"totalMentions": 172,
"visibleResults": 181,
"totalResults": 420,
"visibilityRate": 43.1,
"visibilityChange": -1.4,
"visibilityIsMentionOnly": false,
"mentionRate": 41.0,
"mentionRateChange": -0.9,
"totalCitations": 24,
"citationRate": 5.7,
"citationRateChange": -0.5,
"averagePosition": 21.4,
"sentimentScore": 0.62,
"promptCount": 42
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 15,
"hasMore": false
}
}
}