curl --request POST \
--url https://api.finseo.ai/v1/projects/PROJECT_ID/attribution \
--header "Authorization: Bearer $FINSEO_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"channelId": "ai_search",
"respondentEmail": "jane@company.com",
"respondentName": "Jane Smith",
"dealValue": 12000,
"dealCurrency": "EUR",
"formId": "signup_form_v2",
"pageUrl": "https://example.com/signup"
}'
{
"data": {
"id": "a1b2c3d4-...",
"channel_id": "ai_search",
"channel_label": "AI Search (ChatGPT, Perplexity, etc.)",
"channel_category": "ai_search",
"respondent_email": "jane@company.com",
"deal_value": 12000,
"source": "api",
"created_at": "2026-03-15T10:30:00Z"
}
}
Attribution
Crea un'attribuzione
POST
/
v1
/
projects
/
{projectId}
/
attribution
curl --request POST \
--url https://api.finseo.ai/v1/projects/PROJECT_ID/attribution \
--header "Authorization: Bearer $FINSEO_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"channelId": "ai_search",
"respondentEmail": "jane@company.com",
"respondentName": "Jane Smith",
"dealValue": 12000,
"dealCurrency": "EUR",
"formId": "signup_form_v2",
"pageUrl": "https://example.com/signup"
}'
{
"data": {
"id": "a1b2c3d4-...",
"channel_id": "ai_search",
"channel_label": "AI Search (ChatGPT, Perplexity, etc.)",
"channel_category": "ai_search",
"respondent_email": "jane@company.com",
"deal_value": 12000,
"source": "api",
"created_at": "2026-03-15T10:30:00Z"
}
}
Registra una risposta di attribuzione self-reported. Usa questo Endpoint per tracciare come i clienti hanno scoperto il tuo brand — da AI search, organico, social, annunci, referral o qualsiasi canale personalizzato.
Richiede lo Scope
write sulla tua API Key.
string
obbligatorio
L’ID del progetto.
string
obbligatorio
Identificatore del canale di attribuzione. Usa gli ID standard come
ai_search, ai_chatgpt, ai_perplexity, google_search, social_media, paid_ads, referral, content, oppure una stringa personalizzata qualsiasi.string
Indirizzo email del lead.
string
Nome completo del lead.
string
ID esterno proveniente dal tuo CRM o dal tuo sistema.
number
Importo di ricavo attribuito a questo lead.
string
predefinito:"USD"
Codice valuta ISO.
string
Identificatore del form di origine (es. form_id di Typeform, ID del form HubSpot).
string
URL della pagina in cui è stato inviato il form.
object
Dati personalizzati aggiuntivi come coppie chiave-valore.
curl --request POST \
--url https://api.finseo.ai/v1/projects/PROJECT_ID/attribution \
--header "Authorization: Bearer $FINSEO_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"channelId": "ai_search",
"respondentEmail": "jane@company.com",
"respondentName": "Jane Smith",
"dealValue": 12000,
"dealCurrency": "EUR",
"formId": "signup_form_v2",
"pageUrl": "https://example.com/signup"
}'
{
"data": {
"id": "a1b2c3d4-...",
"channel_id": "ai_search",
"channel_label": "AI Search (ChatGPT, Perplexity, etc.)",
"channel_category": "ai_search",
"respondent_email": "jane@company.com",
"deal_value": 12000,
"source": "api",
"created_at": "2026-03-15T10:30:00Z"
}
}