Skip to main content

Click report

Endpoint: https://app.partnerboost.com/api.php?mod=medium&op=transfer

Auth: Partner API authentication

Required parameters

KeyDescription
tokenChannel API token
begin_dateFormat: YYYY-MM-DD HH:mm:ss
end_dateFormat: YYYY-MM-DD HH:mm:ss

Rate limits

warning

The span between begin_date and end_date cannot exceed one hour. Maximum 10 requests per minute.

Return fields

KeyDescription
channel_idChannel ID
total_pageTotal number of pages
total_itemsTotal transactions broken down by items
brand_idBrand ID, a series of numbers, like 66303
mcidUnique identifier for the brand, a series of characters, like ulike0
midDeprecated, for removal. This parameter is subject to removal in a future version.
merchant_nameBrand Name
uiduid, your custom tracking variable (tag)
click_timeThe time the customer clicks your link, in UTC 8 timezone
click_refA unique transaction reference identification

Request:

{
"token": "YOUR_CHANNEL_TOKEN",
"begin_date": "2024-01-01 00:00:00",
"end_date": "2024-01-01 01:00:00"
}

Response:

{
"status": { "code": 0, "msg": "Success" },
"data": {
"total_page": "1",
"total_items": 1,
"list": [
{
"channel_id": "PB00039713",
"brand_id": "66303",
"mcid": "example",
"mid": "",
"merchant_name": "Example Brand",
"uid": "campaign-a",
"click_time": "2024-01-01 14:49:17",
"click_ref": "pb_xx95"
}
]
}
}

Pagination

Loop hourly windows and increment page when total_page > 1.