curl --request POST \
--url https://api.finseo.ai/v1/projects \
--header "Authorization: Bearer $FINSEO_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"name": "Finseo Labs",
"websiteUrl": "https://labs.finseo.ai",
"language": "en",
"description": "Experimental prompts and benchmarks"
}'
import requests
payload = {
"name": "Finseo Labs",
"websiteUrl": "https://labs.finseo.ai",
"language": "en",
"description": "Experimental prompts and benchmarks",
}
r = requests.post(
"https://api.finseo.ai/v1/projects",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
json=payload,
)
created = r.json()["data"]
print(created["id"])
{
"data": {
"id": "67f8a1b2c3d4e5f60718293a4",
"name": "Finseo Labs",
"websiteUrl": "https://labs.finseo.ai",
"domain": "labs.finseo.ai",
"description": "Experimental prompts and benchmarks",
"isDefault": false,
"tags": [],
"language": "en",
"models": ["chatgpt", "perplexity", "ai_overview"],
"createdAt": "2026-03-29T08:30:00.000Z",
"updatedAt": "2026-03-29T08:30:00.000Z"
}
}
{
"data": {
"id": "67f8a1b2c3d4e5f60718293a4",
"name": "Prospect GmbH",
"websiteUrl": "https://prospect.example",
"domain": "prospect.example",
"description": "",
"isDefault": false,
"tags": [],
"isPitch": true,
"pitchDurationDays": 1,
"language": "de",
"models": ["chatgpt", "perplexity", "ai_overview"],
"createdAt": "2026-09-04T21:12:55.798Z",
"updatedAt": "2026-09-04T21:12:55.798Z"
}
}
Projects
Créer un projet
POST
/
v1
/
projects
curl --request POST \
--url https://api.finseo.ai/v1/projects \
--header "Authorization: Bearer $FINSEO_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"name": "Finseo Labs",
"websiteUrl": "https://labs.finseo.ai",
"language": "en",
"description": "Experimental prompts and benchmarks"
}'
import requests
payload = {
"name": "Finseo Labs",
"websiteUrl": "https://labs.finseo.ai",
"language": "en",
"description": "Experimental prompts and benchmarks",
}
r = requests.post(
"https://api.finseo.ai/v1/projects",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
json=payload,
)
created = r.json()["data"]
print(created["id"])
{
"data": {
"id": "67f8a1b2c3d4e5f60718293a4",
"name": "Finseo Labs",
"websiteUrl": "https://labs.finseo.ai",
"domain": "labs.finseo.ai",
"description": "Experimental prompts and benchmarks",
"isDefault": false,
"tags": [],
"language": "en",
"models": ["chatgpt", "perplexity", "ai_overview"],
"createdAt": "2026-03-29T08:30:00.000Z",
"updatedAt": "2026-03-29T08:30:00.000Z"
}
}
{
"data": {
"id": "67f8a1b2c3d4e5f60718293a4",
"name": "Prospect GmbH",
"websiteUrl": "https://prospect.example",
"domain": "prospect.example",
"description": "",
"isDefault": false,
"tags": [],
"isPitch": true,
"pitchDurationDays": 1,
"language": "de",
"models": ["chatgpt", "perplexity", "ai_overview"],
"createdAt": "2026-09-04T21:12:55.798Z",
"updatedAt": "2026-09-04T21:12:55.798Z"
}
}
Crée un nouveau projet. Finseo suivra la visibilité IA de la marque associée à ce projet sur ChatGPT, Claude, Perplexity et les modèles configurés.
Un nouveau projet démarre avec les modèles IA par défaut de votre compte
(renvoyés dans
models). Définissez les modèles de ce projet avec
Mettre à jour le projet avant d’ajouter des
prompts — les prompts s’exécutent toujours sur les modèles du projet.
Les mêmes limites s’appliquent que dans la boîte de dialogue de création du
dashboard : sur les offres Brand, le plafond de projets de l’offre ; sur les
offres Agency, les slots de projets clients inclus (les projets pitch sont des
slots gratuits) et les slots de projets pitch inclus. Un dépassement de limite
renvoie 403 avec error.details.reason = agency_limit
(details.limit = "projects") ou pitch_project_limit.
string
requis
Nom d’affichage (1–200 caractères).
string
requis
Langue de l’analyse de marque et des prompts générés (insensible à la casse).
Valeurs acceptées :
en, de, fr, es, it, nl, pt, pl, sv, da, tr, ja,
no, fi, cs, ru, zh, zh-tw, ko, hi, ar, he.string
URL canonique du site ; utilisée pour déduire
domain en cas d’omission.string
Domaine racine (p. ex.
finseo.ai). Facultatif si websiteUrl est fourni.string
Notes facultatives (500 caractères max).
boolean
Crée un projet pitch sans frais de projet, limité à 50 prompts et mis
automatiquement en pause à la fin de la période. Idéal pour les analyses
ponctuelles de prospects par les agents commerciaux. Les slots sont limités
selon l’offre agence (250 avec Agency Starter, 500 avec Agency Studio).
number
défaut:"14"
Durée du pitch en jours :
1 (exécution unique), 7 ou 14. Ignoré sauf si
isPitch vaut true. Convertissez un pitch gagné avec
Mettre à jour le projet et convertFromPitch.curl --request POST \
--url https://api.finseo.ai/v1/projects \
--header "Authorization: Bearer $FINSEO_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"name": "Finseo Labs",
"websiteUrl": "https://labs.finseo.ai",
"language": "en",
"description": "Experimental prompts and benchmarks"
}'
import requests
payload = {
"name": "Finseo Labs",
"websiteUrl": "https://labs.finseo.ai",
"language": "en",
"description": "Experimental prompts and benchmarks",
}
r = requests.post(
"https://api.finseo.ai/v1/projects",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
json=payload,
)
created = r.json()["data"]
print(created["id"])
{
"data": {
"id": "67f8a1b2c3d4e5f60718293a4",
"name": "Finseo Labs",
"websiteUrl": "https://labs.finseo.ai",
"domain": "labs.finseo.ai",
"description": "Experimental prompts and benchmarks",
"isDefault": false,
"tags": [],
"language": "en",
"models": ["chatgpt", "perplexity", "ai_overview"],
"createdAt": "2026-03-29T08:30:00.000Z",
"updatedAt": "2026-03-29T08:30:00.000Z"
}
}
{
"data": {
"id": "67f8a1b2c3d4e5f60718293a4",
"name": "Prospect GmbH",
"websiteUrl": "https://prospect.example",
"domain": "prospect.example",
"description": "",
"isDefault": false,
"tags": [],
"isPitch": true,
"pitchDurationDays": 1,
"language": "de",
"models": ["chatgpt", "perplexity", "ai_overview"],
"createdAt": "2026-09-04T21:12:55.798Z",
"updatedAt": "2026-09-04T21:12:55.798Z"
}
}