Advertiser statistics

GET/login/advertiser/stats

Access: authenticated advertiser, restricted to owned campaigns.

Authenticate with Authorization: Bearer MEMBER_ACCESS_TOKEN or your secure member session.

Authentication and error codes →

Returns campaign performance for the authenticated advertiser.

Common parameters

Parameter	Required	Description
date_from	Yes	Inclusive start date.
date_to	Yes	Inclusive end date.
page	No	Page number, default 1.
perPage	No	Rows per page, maximum 200.
sort	No	Backend sort field.
order	No	asc or desc.
interval	No	1, 7, or 30.
timezone	No	Reporting timezone; default UTC.
table_type	No	cid, sid, geo, os, browser, domains, carrier, connections, or device.
cids	No	Repeated owned campaign IDs.
types, tids, geos, os, browser	No	Repeated filters supported by the selected table.

cURL

curl --get "https://example.com/api/v1/login/advertiser/stats" \
  --header "Authorization: Bearer MEMBER_ACCESS_TOKEN" \
  --data-urlencode "date_from=2026-08-01" \
  --data-urlencode "date_to=2026-08-17" \
  --data-urlencode "table_type=cid" \
  --data-urlencode "cids=123"

JavaScript

const params = new URLSearchParams({ date_from: '2026-08-01', date_to: '2026-08-17', table_type: 'cid', cids: '123' });
const response = await fetch(`https://example.com/api/v1/login/advertiser/stats?${params}`, {
  headers: { Authorization: `Bearer ${process.env.MEMBER_ACCESS_TOKEN}` },
});
if (!response.ok) throw new Error(`Nexus returned ${response.status}`);
console.log(await response.json());

Python

import os
import requests

response = requests.get(
    'https://example.com/api/v1/login/advertiser/stats',
    headers={'Authorization': f"Bearer {os.environ['MEMBER_ACCESS_TOKEN']}"},
    params={'date_from': '2026-08-01', 'date_to': '2026-08-17', 'table_type': 'cid', 'cids': 123},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Response

The response is paginated and includes data, total, currentPage, and totalPages.

Multiple campaign filters

Repeating cids filters multiple campaigns, for example cids=123&cids=456. Every requested campaign remains subject to member ownership checks.

Authentication and errors

This endpoint is served by the tenant member backend at https://example.com/api/v1. Use a member access JWT; publisher reporting keys do not authenticate this route. Each requested campaign must belong to the authenticated advertiser. Handle non-success HTTP responses before consuming the paginated body, and use the backend's returned validation/authentication message to diagnose rejected requests.