Documentation Index Fetch the complete documentation index at: https://docs.growthchannel.com/llms.txt
Use this file to discover all available pages before exploring further.
Maximum date range 31 day
This endpoint is protected and requires an agency API key for access.
Request
Request with optional filters
curl --request GET \
--url 'https://api.growthchannel.io/conversion/?date_from=2026-04-08&date_to=2026-04-14&advertiser_id=123456' \
--header 'X-Api-Key: your_api_key'
The agency API key used for authorization.
Parameters
Only date_from, date_to, and advertiser_id are required. If you do not need an optional parameter, omit it entirely instead of sending an empty value (for example, avoid page=).
Start date in YYYY-MM-DD format.
End date in YYYY-MM-DD format.
Unique identifier of the advertiser.
Optional free-text search filter.
Optional sort column (for example: date, campaign_name, conversions).
Optional sort direction (ASC or DESC).
Optional page number for pagination (0-based).
Optional flag to enable conversion deduplication.
Optional flag to include DSP-specific fields when available.
Optional campaign ID filter.
Responses
{
"status" : "success" ,
"part_error" : {},
"data" : {
"data" : [
{
"date" : "2026-04-14" ,
"our_advertiser_id" : 123456 ,
"our_campaign_id" : 10001 ,
"campaign_name" : "Sample Q2 Brand Awareness - EN" ,
"impressions" : 12540 ,
"clicks" : 212 ,
"total_spend" : 184.37 ,
"transaction_id" : "TXN-EXAMPLE-0001" ,
"domain" : "example-news.com" ,
"conversion_tracker" : "offsite_conversion.example_purchase" ,
"device" : "WEB" ,
"conversion_time" : "2026-04-14 09:24:10" ,
"last_click_time" : "2026-04-14 09:21:02" ,
"last_impression_time" : "2026-04-14 09:20:44" ,
"conversions" : 3
},
{
"date" : "2026-04-08" ,
"our_advertiser_id" : 123456 ,
"our_campaign_id" : 10002 ,
"campaign_name" : "Sample Retargeting - Mobile App" ,
"impressions" : 41697 ,
"clicks" : 468 ,
"total_spend" : 320.11 ,
"transaction_id" : "TXN-EXAMPLE-0002" ,
"domain" : "social-app" ,
"conversion_tracker" : "offsite_conversion.example_signup" ,
"device" : "APP" ,
"conversion_time" : "2026-04-08 00:00:00" ,
"last_click_time" : null ,
"last_impression_time" : null ,
"conversions" : 6145
}
],
"pagination" : {
"current_page" : 0 ,
"total_pages" : 5 ,
"total_count" : 89
}
}
}
Partial error container; empty when no partial issues occur.
Response payload object. List of conversion-level records.
Pagination metadata. Current page number (0-based).
Returned if required query parameters like date_from, date_to, or advertiser_id are missing. {
"error" : {
"code" : "VALIDATION_ERROR" ,
"message" : "Missing required parameters" ,
"details" : {
"missing_fields" : [ "date_from" , "date_to" , "advertiser_id" ]
},
"request_id" : "..."
}
}
Returned if the X-Api-Key header is missing or invalid.
Returned if there is an unexpected error on the server while fetching data.