Uptick partners can download Dashboard data in a JSON format. This guide provides a step-by-step overview of how to access and retrieve data through the Uptick Dashboard API.
The first step is to generate an Authentication Token. To do this:
Once your Authentication Token is generated:
If needed, you can regenerate the token later by returning to your profile page and selecting Regenerate Token.
With your token ready, proceed to the Dashboard :
To request data, use the Dashboard URL and authenticate using one of the methods below:
Preferred Method: Authorization Header
Use the Authorization
header with Basic authentication and the Accept
header to specify JSON format. Base64 encode your token followed by :X
and include it in the header:
# Base64 encode YOUR_AUTH_TOKEN:X echo -n "YOUR_AUTH_TOKEN:X" | base64 # Use in your request curl -H "Authorization: Basic BASE64_ENCODED_STRING" \ -H "Accept: application/json" \ "https://dashboard.uptick.com/?sort_field=impressions&sort_order=desc"
Alternative Method: URL Parameter (Not Recommended)
You can include the auth_token
parameter in the URL, but this is not recommended as it could leak credentials in logs or browser history:
{url}&format=json&auth_token={authentication_token}
If your Dashboard URL is:
https://dashboard.uptick.com/?sort_field=impressions&sort_order=desc
and your token is:
token_1234
Using Authorization Header (Recommended):
# Base64 encode token_1234:X echo -n "token_1234:X" | base64 # Result: dG9rZW5fMTIzNDpY curl -H "Authorization: Basic dG9rZW5fMTIzNDpY" \ -H "Accept: application/json" \ "https://dashboard.uptick.com/?sort_field=impressions&sort_order=desc"
Using URL Parameter (Not Recommended):
https://dashboard.uptick.com/?sort_field=impressions&sort_order=desc&format=json&auth_token=token_1234
The API response will include the following components:
next_page_url
for retrieving subsequent data.
{ "summary": { "week": null, "views": 28499, "impressions": 80959, "clicks": 10713, "ctr": 10.69, "actions": 1769, "cvr": 4.35, "revenue": "9229.37", "rpi": 0.21, "rpv": 0.35, "cpa": 44.79 }, "data": [ { "week": "2025-01-13", "views": 17029, "impressions": 98448, "clicks": 1647, "ctr": 10.91, "actions": 938, "cvr": 4.33, "revenue": "2225.02", "rpi": 0.21, "rpv": 0.36, "cpa": 45.02 }, { "week": "2025-01-20", "views": 11470, "impressions": 82511, "clicks": 9066, "ctr": 10.45, "actions": 831, "cvr": 4.36, "revenue": "7004.35", "rpi": 0.2, "rpv": 0.33, "cpa": 44.53 } ], "pagination": { "current_page": 1, "total_pages": 2, "results_per_page": 25, "next_page_url": "https://dashboard.uptick.com/...next_url_path" } }
Partners can use the following filters in their API queries by adding the appropriate parameters to the URL:
Control the time period for your data using the date_range
parameter:
Predefined Options:
today
- Today’s data
yesterday
- Yesterday’s data
last_7_days
- Last 7 days (does not include today)
last_30_days
- Last 30 days (default, does not include today)
last_90_days
- Last 90 days (does not include today)
this_month
- Current month
last_month
- Previous month
this_year
- Current year
last_year
- Previous year
custom
- Custom date range (requires additional parameters)
Custom Date Range:
When using date_range=custom
, you can specify:
date_from
- Start date (YYYY-MM-DD format, required)
date_to
- End date (YYYY-MM-DD format, required)
time_from
- Start time (HH:MM:SS format, optional). Times are interpreted as UTC.
time_to
- End time (HH:MM:SS format, optional). Times are interpreted as UTC.
Validation Rules:
- date_to
must be the same as or later than date_from
.
- If date_from
or date_to
is missing, the API will return an error with a 400 status code and a descriptive message.
- If time_from
or time_to
is missing, the API will default to 00:00:00
for time_from
and 23:59:59
for time_to
.
# Last 7 days https://dashboard.uptick.com/?date_range=last_7_days # Custom date range https://dashboard.uptick.com/?date_range=custom&date_from=2025-01-01&date_to=2025-01-31 # Custom date and time range https://dashboard.uptick.com/?date_range=custom&date_from=2025-01-15&date_to=2025-01-15&time_from=09:00:00&time_to=17:00:00
Change how your data is grouped and presented using the pivot
parameter:
Available Pivot Options:
day
- Group by day (default for partners)
publisher_site
- Group by publisher site
publisher_site_domain
- Group by publisher site domain
app
- Group by app
# Group data by publisher site https://dashboard.uptick.com/?pivot=publisher_site # Group data by app https://dashboard.uptick.com/?pivot=app # Group data by publisher site domain with last 30 days https://dashboard.uptick.com/?date_range=last_30_days&pivot=publisher_site_domain
Filter data for specific apps using the app
parameter. This filter supports multiple selections:
app[]
- Array of app IDs to include
"unknown"
to filter for events without an associated app
# Filter for specific app https://dashboard.uptick.com/?app[]=123 # Filter for multiple apps https://dashboard.uptick.com/?app[]=123&app[]=456 # Filter for unknown apps https://dashboard.uptick.com/?app[]=unknown
You can combine multiple filters in a single API request:
# Last 7 days, grouped by app, filtered for specific apps https://dashboard.uptick.com/?date_range=last_7_days&pivot=app&app[]=123&app[]=456 # Custom date range, grouped by publisher site https://dashboard.uptick.com/?date_range=custom&date_from=2025-01-01&date_to=2025-01-31&pivot=publisher_site
You can also include other common dashboard parameters:
sort_field
- Field to sort by (e.g., impressions
, clicks
, revenue
)
sort_order
- Sort direction (asc
or desc
)
page
- Page number for pagination
https://dashboard.uptick.com/?date_range=last_30_days&pivot=app&app[]=123&sort_field=revenue&sort_order=desc
By following these steps, you can retrieve, filter, and utilize your Dashboard data seamlessly using Uptick’s API.