Skip to main content
POST
/
public
/
v1
/
attribution
Attribution by source
curl --request POST \
  --url http://app.stairoids.com/api/public/v1/attribution \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "startDate": 1717200000000,
  "endDate": 1719792000000,
  "icpIds": [
    123
  ],
  "accountListIds": [
    123
  ]
}
'
{
  "totalVisits": 5230,
  "withUtm": 3110,
  "utmCoverage": 59.5,
  "sources": [
    {
      "id": "linkedin",
      "name": "LinkedIn",
      "visits": 1840,
      "withUtm": 1700,
      "utmPercentage": 92.4,
      "knownCompanies": 420,
      "companiesWithSignals": 190,
      "funnelStages": {}
    }
  ]
}

Authorizations

​
X-Api-Key
string
header
required

Your organization's public API key. Manage it at GET /api/user/public-api-key.

Body

application/json

Time-window and segment filter for analytics endpoints.

​
startDate
integer<int64>

Window start, epoch millis. Omit both startDate and endDate for the default recent window.

Example:

1717200000000

​
endDate
integer<int64>

Window end, epoch millis.

Example:

1719792000000

​
icpIds
integer<int64>[]

Restrict to these ICP ids. Null or empty = all ICPs.

Restrict to these ICP ids. Null or empty = all ICPs.

​
accountListIds
integer<int64>[]

Restrict to these account-list ids. Null or empty = all lists.

Restrict to these account-list ids. Null or empty = all lists.

Response

OK

Marketing attribution: traffic sources and their pipeline impact.

​
totalVisits
integer<int64>

Total tracked visits in the window.

Example:

5230

​
withUtm
integer<int64>

Visits that carried UTM parameters.

Example:

3110

​
utmCoverage
number<double>

Share of visits with UTM data (0-100).

Example:

59.5

​
sources
object[]

Per-source breakdown.