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
Créer une attribution
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"
}
}
Enregistrez une réponse d’attribution auto-déclarée. Utilisez cet Endpoint pour savoir comment vos clients ont découvert votre marque — via la recherche IA, le trafic organique, les réseaux sociaux, la publicité, les recommandations ou tout canal personnalisé.
Nécessite le Scope
write sur votre clé API.
string
requis
L’ID du projet.
string
requis
Identifiant du canal d’attribution. Utilisez des ID standard comme
ai_search, ai_chatgpt, ai_perplexity, google_search, social_media, paid_ads, referral, content, ou toute chaîne personnalisée.string
Adresse e-mail du lead.
string
Nom complet du lead.
string
ID externe issu de votre CRM ou de votre système.
number
Montant de revenu attribué à ce lead.
string
défaut:"USD"
Code de devise ISO.
string
Identifiant du formulaire source (p. ex. form_id Typeform, ID de formulaire HubSpot).
string
URL de la page où le formulaire a été soumis.
object
Données personnalisées supplémentaires sous forme de paires clé-valeur.
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"
}
}