Skip to main content
GET
/
conversion
/
?date_from=
{date_from}
&date_to=
{date_to}
&advertiser_id=
{advertiser_id}
  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'
Maximum date range 7 days
This endpoint is protected and requires an agency API key for access.
  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'

Method

GET

Endpoint

/conversion/

​
Headers

​
X-Api-Key
string
required
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=).
​
date_from
string
required
Start date in YYYY-MM-DD format.
​
date_to
string
required
End date in YYYY-MM-DD format.
​
advertiser_id
integer
required
Unique identifier of the advertiser.
​
search
string
Optional free-text search filter.
​
sort_column
string
default:"date"
Optional sort column (for example: date, campaign_name, conversions).
​
sort_order
string
default:"DESC"
Optional sort direction (ASC or DESC).
​
page
integer
default:"0"
Optional page number for pagination (0-based).
​
with_deduplication
boolean
default:"true"
Optional flag to enable conversion deduplication.
​
with_dsp
boolean
default:"false"
Optional flag to include DSP-specific fields when available.
​
campaign_id
integer
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
    }
  }
}
​
status
string
Request status value.
​
part_error
object
Partial error container; empty when no partial issues occur.
​
data
object
Response payload object.