Skip to main content
GET
/
v1
/
projects
/
{projectId}
/
attribution
curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/PROJECT_ID/attribution?days=30&category=ai_search' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

{
  "data": {
    "responses": [
      {
        "id": "a1b2c3d4-...",
        "channel_id": "ai_search",
        "channel_label": "AI Search (ChatGPT, Perplexity, etc.)",
        "channel_category": "ai_search",
        "respondent_email": "jane@company.com",
        "respondent_name": "Jane Smith",
        "deal_value": 12000,
        "deal_currency": "USD",
        "source": "hubspot",
        "page_url": "https://example.com/signup",
        "form_id": "lT4Z3j",
        "created_at": "2026-03-15T10:30:00Z"
      }
    ],
    "meta": {
      "page": 1,
      "limit": 50,
      "total": 142,
      "hasMore": true
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.finseo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Get paginated attribution survey responses for a project. Filter by channel category, source, and time range.
​
projectId
string
required
The project ID.
​
days
integer
default:"30"
Number of days to look back.
​
category
string
Filter by channel category: ai_search, organic_search, paid, social, referral, content, direct, other.
​
source
string
Filter by data source: widget, hubspot, typeform, jotform, salesforce, api, api_bulk.
​
page
integer
default:"1"
Page number.
​
limit
integer
default:"50"
Results per page (max 500).
curl --request GET \
  --url 'https://api.finseo.ai/v1/projects/PROJECT_ID/attribution?days=30&category=ai_search' \
  --header 'Authorization: Bearer sk_live_xxxxxxxx'

{
  "data": {
    "responses": [
      {
        "id": "a1b2c3d4-...",
        "channel_id": "ai_search",
        "channel_label": "AI Search (ChatGPT, Perplexity, etc.)",
        "channel_category": "ai_search",
        "respondent_email": "jane@company.com",
        "respondent_name": "Jane Smith",
        "deal_value": 12000,
        "deal_currency": "USD",
        "source": "hubspot",
        "page_url": "https://example.com/signup",
        "form_id": "lT4Z3j",
        "created_at": "2026-03-15T10:30:00Z"
      }
    ],
    "meta": {
      "page": 1,
      "limit": 50,
      "total": 142,
      "hasMore": true
    }
  }
}