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
Crea un progetto
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"
}
}
Crea un nuovo progetto. Finseo traccerà la visibilità AI del brand associato a questo progetto su ChatGPT, Claude, Perplexity e i modelli configurati.
Un nuovo progetto parte con i modelli AI predefiniti del tuo account (restituiti
come
models). Imposta i modelli di questo progetto con
Aggiorna progetto prima di aggiungere prompt —
i prompt vengono sempre eseguiti sui modelli del progetto.
Si applicano gli stessi limiti della finestra di creazione della dashboard: sui
piani Brand il numero massimo di progetti del piano, sui pacchetti Agency gli
slot per progetti cliente inclusi (i progetti pitch sono slot gratuiti) e gli
slot per progetti pitch inclusi. Una violazione dei limiti restituisce 403 con
error.details.reason = agency_limit (details.limit = "projects") oppure
pitch_project_limit.
string
obbligatorio
Nome visualizzato (1–200 caratteri).
string
obbligatorio
Lingua dell’analisi del brand e dei prompt generati (senza distinzione tra maiuscole).
Valori ammessi:
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 canonico del sito; usato per dedurre
domain quando questo viene omesso.string
Dominio radice (es.
finseo.ai). Facoltativo se fornisci websiteUrl.string
Note facoltative (max 500 caratteri).
boolean
Crea un progetto pitch senza costo di progetto, limitato a 50 prompt e
sospeso automaticamente alla chiusura della finestra. Ideale per analisi
una tantum dei prospect da parte degli agenti commerciali. Gli slot dipendono
dal piano agenzia (250 con Agency Starter, 500 con Agency Studio).
number
predefinito:"14"
Finestra del pitch in giorni:
1 (esecuzione unica), 7 o 14. Ignorato se
isPitch non è true. Converti un pitch vinto con
Aggiorna progetto e 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"
}
}