curl --request GET \
--url https://api.finseo.ai/v1/projects \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
response = requests.get(
"https://api.finseo.ai/v1/projects",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
)
projects = response.json()["data"]
for p in projects:
print(p["name"], p["id"])
{
"data": [
{
"id": "67a1c2d3e4f5061728394a5b",
"name": "Finseo Marketing",
"domain": "finseo.ai",
"websiteUrl": "https://finseo.ai",
"description": "AI visibility tracking for modern brands",
"isDefault": true,
"tags": ["product", "b2b"],
"language": "en",
"models": ["chatgpt", "perplexity", "ai_overview"],
"isPitch": false,
"createdAt": "2025-11-12T10:15:00.000Z",
"updatedAt": "2026-03-28T14:22:00.000Z"
},
{
"id": "67b2d3e4f5061728394a5c",
"name": "Acme Corp (Pitch)",
"domain": "acme.com",
"websiteUrl": "https://www.acme.com",
"description": "",
"isDefault": false,
"tags": [],
"language": "de",
"models": ["chatgpt", "perplexity", "ai_overview", "claude"],
"isPitch": true,
"pitchDurationDays": 7,
"pitchExpiredAt": null,
"createdAt": "2026-01-08T09:00:00.000Z",
"updatedAt": "2026-03-15T11:45:00.000Z"
}
]
}
Projects
Elenca i progetti
GET
/
v1
/
projects
curl --request GET \
--url https://api.finseo.ai/v1/projects \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
response = requests.get(
"https://api.finseo.ai/v1/projects",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
)
projects = response.json()["data"]
for p in projects:
print(p["name"], p["id"])
{
"data": [
{
"id": "67a1c2d3e4f5061728394a5b",
"name": "Finseo Marketing",
"domain": "finseo.ai",
"websiteUrl": "https://finseo.ai",
"description": "AI visibility tracking for modern brands",
"isDefault": true,
"tags": ["product", "b2b"],
"language": "en",
"models": ["chatgpt", "perplexity", "ai_overview"],
"isPitch": false,
"createdAt": "2025-11-12T10:15:00.000Z",
"updatedAt": "2026-03-28T14:22:00.000Z"
},
{
"id": "67b2d3e4f5061728394a5c",
"name": "Acme Corp (Pitch)",
"domain": "acme.com",
"websiteUrl": "https://www.acme.com",
"description": "",
"isDefault": false,
"tags": [],
"language": "de",
"models": ["chatgpt", "perplexity", "ai_overview", "claude"],
"isPitch": true,
"pitchDurationDays": 7,
"pitchExpiredAt": null,
"createdAt": "2026-01-08T09:00:00.000Z",
"updatedAt": "2026-03-15T11:45:00.000Z"
}
]
}
Restituisce l’elenco dei progetti a cui la tua API Key può accedere. I progetti rappresentano i brand o i domini tracciati in Finseo per la visibilità AI su ChatGPT, Claude, Perplexity e altri modelli.
Ogni progetto include
isPitch. I progetti pitch includono anche pitchDurationDays (1, 7 o 14) e pitchExpiredAt (null finché la finestra è aperta), così un agente può sapere per quanto tempo continuerà senza fare supposizioni.
Ogni progetto restituisce inoltre language (la lingua dei prompt impostata alla creazione, null sui progetti più vecchi) e models — i modelli AI su cui vengono eseguiti i suoi prompt, ossia le Impostazioni modelli della dashboard. Usa questi valori per il filtro model degli endpoint delle metriche e modificali con Aggiorna progetto.
curl --request GET \
--url https://api.finseo.ai/v1/projects \
--header "Authorization: Bearer $FINSEO_API_KEY"
import requests
response = requests.get(
"https://api.finseo.ai/v1/projects",
headers={"Authorization": "Bearer sk_live_xxxxxxxx"},
)
projects = response.json()["data"]
for p in projects:
print(p["name"], p["id"])
{
"data": [
{
"id": "67a1c2d3e4f5061728394a5b",
"name": "Finseo Marketing",
"domain": "finseo.ai",
"websiteUrl": "https://finseo.ai",
"description": "AI visibility tracking for modern brands",
"isDefault": true,
"tags": ["product", "b2b"],
"language": "en",
"models": ["chatgpt", "perplexity", "ai_overview"],
"isPitch": false,
"createdAt": "2025-11-12T10:15:00.000Z",
"updatedAt": "2026-03-28T14:22:00.000Z"
},
{
"id": "67b2d3e4f5061728394a5c",
"name": "Acme Corp (Pitch)",
"domain": "acme.com",
"websiteUrl": "https://www.acme.com",
"description": "",
"isDefault": false,
"tags": [],
"language": "de",
"models": ["chatgpt", "perplexity", "ai_overview", "claude"],
"isPitch": true,
"pitchDurationDays": 7,
"pitchExpiredAt": null,
"createdAt": "2026-01-08T09:00:00.000Z",
"updatedAt": "2026-03-15T11:45:00.000Z"
}
]
}