List Attributions

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
    }
  }
}

GET

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
    }
  }
}

Get paginated attribution survey responses for a project. Filter by channel category, source, and time range.

string

required

The project ID.

integer

default:"30"

Number of days to look back.

string

Filter by channel category: ai_search, organic_search, paid, social, referral, content, direct, other.

string

Filter by data source: widget, hubspot, typeform, jotform, salesforce, api, api_bulk.

integer

default:"1"

Page number.

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
    }
  }
}

Projects

Prompts

Metrics

Competitors

Sources

Tags

Fan-outs

Tasks

Export

Attribution

List Attributions