Attribution (Beta)
Query multi-touch Conversion Attribution and Audience Performance conversion reports via the REST API. These endpoints are in beta.
Query multi-touch Conversion Attribution and Audience Performance conversion reports for a conversion event over a date window. These endpoints are in beta — the response shape may change before GA.
Authorization
apiKey Ours Privacy API key
In: header
Query Parameters
Inclusive lower bound of the analytics window, as a UTC calendar day in YYYY-MM-DD format. The window between from and to must be 31 days or fewer.
Inclusive upper bound of the analytics window, as a UTC calendar day in YYYY-MM-DD format. The window between from and to must be 31 days or fewer.
Conversion event to attribute. Must be a selectable conversion event.
Attribution model to apply to multi-touch conversion paths.
How far back before each conversion to consider touchpoints. Capped at 60 days for this report. Defaults to THIRTY_DAYS.
Maximum number of leaf-level attribution rows to return. Defaults to 1000.
Scope to a single web source by id, or omit for all sources (account-wide).
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/rest/v1/attribution/conversion?from=2026-06-01&to=2026-06-30&eventName=purchase&attributionModel=FIRST_TOUCH"{
"summary": {
"totalEventConverters": 0,
"scopeConverters": 0,
"attributedConverters": 0,
"totalSessions": 0
},
"nodes": [
{
"level": "SOURCE",
"source": "string",
"medium": "string",
"campaign": "string",
"attributedConverterCredit": 0,
"converters": 0,
"sessions": 0
}
],
"isTruncated": true,
"totalLeafRows": 0,
"maxLeafRows": 0
}{
"error": "string",
"details": "string"
}{
"error": "string",
"details": "string"
}{
"error": "string",
"details": "string"
}{
"error": "string",
"details": "string"
}{
"error": "string",
"details": "string"
}Authorization
apiKey Ours Privacy API key
In: header
Query Parameters
Inclusive lower bound of the analytics window, as a UTC calendar day in YYYY-MM-DD format. The window between from and to must be 60 days or fewer.
Inclusive upper bound of the analytics window, as a UTC calendar day in YYYY-MM-DD format. The window between from and to must be 60 days or fewer.
Conversion event to analyze.
Event property to sum as conversion value.
Attribution window: IN_RANGE or a number of lookback days (e.g. 7, 30). Defaults to IN_RANGE.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/rest/v1/attribution/audience-conversion?from=2026-05-01&to=2026-06-30&eventName=purchase"{
"summary": {
"audienceSize": 0,
"conversions": 0,
"totalValue": 0,
"converters": 0,
"conversionRate": 0,
"avgValuePerConversion": 0,
"avgValuePerConvertingVisitor": 0
},
"previousSummary": {
"audienceSize": 0,
"conversions": 0,
"totalValue": 0,
"converters": 0,
"conversionRate": 0,
"avgValuePerConversion": 0,
"avgValuePerConvertingVisitor": 0
},
"timeseries": [
{
"date": "string",
"conversions": 0,
"totalValue": 0
}
],
"breakdown": [
{
"source": "string",
"medium": "string",
"campaign": "string",
"conversions": 0,
"converters": 0,
"totalValue": 0
}
]
}{
"error": "string",
"details": "string"
}{
"error": "string",
"details": "string"
}{
"error": "string",
"details": "string"
}{
"error": "string",
"details": "string"
}{
"error": "string",
"details": "string"
}How is this guide?