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"
}
}
Projekte
Projekt erstellen
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"
}
}
Erstellt ein neues Projekt. Finseo trackt die KI-Sichtbarkeit der Brand, die zu diesem Projekt gehört, in ChatGPT, Claude, Perplexity und den konfigurierten Modellen.
Ein neues Projekt startet mit den Standard-KI-Modellen deines Accounts
(zurückgegeben als
models). Setze die Modelle für dieses Projekt mit
Projekt aktualisieren, bevor du Prompts
hinzufügst — Prompts laufen immer auf den Modellen des Projekts.
Es gelten dieselben Limits wie im Erstellen-Dialog des Dashboards: bei
Brand-Tarifen das Projekt-Limit des Tarifs, bei Agenturpaketen die
inkludierten Kundenprojekt-Slots (Pitch-Projekte sind kostenlose Slots) und
die inkludierten Pitch-Projekt-Slots. Eine Limit-Verletzung liefert 403 mit
error.details.reason = agency_limit (details.limit = "projects") oder
pitch_project_limit.
string
erforderlich
Anzeigename (1–200 Zeichen).
string
erforderlich
Sprache für die Brand-Analyse und die generierten Prompts (Groß-/Kleinschreibung wird ignoriert).
Zulässig sind:
en, de, fr, es, it, nl, pt, pl, sv, da, tr, ja,
no, fi, cs, ru, zh, zh-tw, ko, hi, ar, he.string
Kanonische Website-URL; wird verwendet, um
domain abzuleiten, wenn diese fehlt.string
Root-Domain (z. B.
finseo.ai). Optional, wenn websiteUrl angegeben ist.string
Optionale Notizen (max. 500 Zeichen).
boolean
Erstellt ein Pitch-Projekt ohne Projektgebühr, begrenzt auf 50 Prompts und
mit automatischer Pausierung nach Ablauf des Pitch-Zeitraums. Ideal für
einmalige Interessentenanalysen durch Sales Agents. Pitch-Slots sind je
Agenturpaket begrenzt (z. B. 250 bei Agency Starter, 500 bei Agency Studio).
number
Standard:"14"
Pitch-Zeitraum in Tagen:
1 (einmaliger Lauf), 7 oder 14. Wird ohne
isPitch: true ignoriert. Einen gewonnenen Pitch wandelst du mit
Projekt aktualisieren und convertFromPitch
in ein Kundenprojekt um.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"
}
}