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
Listar proyectos
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"
}
]
}
Devuelve la lista de proyectos a los que tu API Key tiene acceso. Los proyectos representan marcas o dominios que sigues en Finseo para medir la visibilidad en IA a través de ChatGPT, Claude, Perplexity y otros modelos.
Cada proyecto incluye
isPitch. Los proyectos pitch también incluyen pitchDurationDays (1, 7 o 14) y pitchExpiredAt (null mientras la ventana siga abierta), para que un agente sepa cuánto tiempo seguirá activo sin tener que adivinarlo.
Cada proyecto devuelve además language (el idioma de los prompts fijado al crearlo, null en proyectos antiguos) y models — los modelos de IA en los que se ejecutan sus prompts, es decir, los Model Settings del dashboard. Usa estos valores para el filtro model de los endpoints de métricas y cámbialos con Actualizar proyecto.
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"
}
]
}