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"
}
]
}
Projekte
Projekte auflisten
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"
}
]
}
Gibt eine Liste der Projekte zurück, auf die dein API-Key Zugriff hat. Projekte repräsentieren getrackte Brands oder Domains in Finseo für KI-Sichtbarkeit in ChatGPT, Claude, Perplexity und weiteren Modellen.
Jedes Projekt enthält
isPitch. Pitch-Projekte enthalten zusätzlich pitchDurationDays (1, 7 oder 14) und pitchExpiredAt (null, solange das Pitch-Fenster offen ist). So erkennt ein Agent zuverlässig, wie lange ein Pitch noch läuft.
Jedes Projekt liefert außerdem language (die bei der Erstellung gesetzte Prompt-Sprache, null bei älteren Projekten) und models — die KI-Modelle, auf denen seine Prompts laufen, also die Modell-Einstellungen aus dem Dashboard. Verwende diese Werte für den model-Filter der Metrik-Endpoints und ändere sie mit Projekt aktualisieren.
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"
}
]
}