Reports
Performance Report
Returns daily aggregated performance metrics for the authenticated publisher: clicks, transactions, commission, sale amount, conversion rate, and earnings per click. Optionally filter by campaign or channel. The response includes a totals object with aggregates across the entire date range.
GET
/pub_api/v3/reports/performance
read:reports
Query parameters
|
start_date
date (YYYY-MM-DD)
|
Start of date range. Default: 7 days ago. |
|
end_date
date (YYYY-MM-DD)
|
End of date range. Default: yesterday. Maximum range: 90 days. |
|
campaign_id
integer
|
Filter by campaign ID. |
|
channel_id
integer
|
Filter by channel ID. |
|
sort
string
|
Sort field: date (default), clicks, transactions, commission, sale_amount, cr, epc. |
|
order
string
|
asc or desc (default). |
|
page
integer
|
Page number. Default: 1. |
|
per_page
integer
|
Results per page, 1–100. Default: 30. |
Response fields
FieldTypeDescription
data[].date
string
Date (YYYY-MM-DD).
data[].clicks
integer
Total clicks for the day.
data[].transactions
integer
Number of conversions.
data[].commission
string
Publisher commission earned (decimal string; trailing zeros trimmed).
data[].sale_amount
string
Total sale amount (decimal string; trailing zeros trimmed).
data[].cr
string
Conversion rate as percentage (transactions / clicks × 100).
data[].epc
string
Earnings per click (commission / clicks).
totals
object
Aggregated totals across the entire date range (not just the current page). Same fields as each data row, minus
date.
meta
object
Pagination:
page, per_page, total, total_pages, next_page, prev_page.
Request
curl https://developers.cuelinks.com/pub_api/v3/reports/performance \ -H "Authorization: Token YOUR_API_KEY" \ -G \ -d "start_date=2026-04-04" \ -d "end_date=2026-04-10"
Request (with filters)
curl https://developers.cuelinks.com/pub_api/v3/reports/performance \ -H "Authorization: Token YOUR_API_KEY" \ -G \ -d "start_date=2026-04-04" \ -d "end_date=2026-04-10" \ -d "campaign_id=101" \ -d "channel_id=3424" \ -d "sort=clicks" \ -d "order=desc"
200 OK
200
{ "data": [ { "date": "2026-04-10", "clicks": 178312, "transactions": 587, "commission": "15986.19", "sale_amount": "1250000", "cr": "0.33", "epc": "0.09" }, { "date": "2026-04-09", "clicks": 214041, "transactions": 751, "commission": "20288.7", "sale_amount": "1500000", "cr": "0.35", "epc": "0.09" } ], "totals": { "clicks": 392353, "transactions": 1338, "commission": "36274.89", "sale_amount": "2750000", "cr": "0.34", "epc": "0.09" }, "meta": { "page": 1, "per_page": 30, "total": 7, "total_pages": 1, "next_page": null, "prev_page": null } }
422 Unprocessable Entity
422
{ "error": "Date range cannot exceed 90 days" }
Totals across the full range
The
The
totals object aggregates across the entire date range, not just the current page. Use it for summary cards or dashboard widgets without needing to fetch all pages.