Skip to main content
GET
Fans statistics
How many fans you’ve brought in, split by pricing model. This is the same data as the Fans widget in the partner dashboard. The response has three panels: total, revshare and cpl. Each panel contains:

Period

from and to accept a Unix timestamp or a Y-m-d date.
  • Default: the last 14 days.
  • Maximum range: 366 days.
  • A to date in the future is treated as now.
The numbers include CPL campaigns that run on a shared link (limited access). Fans for those campaigns are counted from daily account snapshots.
Responses are cached for 15 minutes.

Authorizations

Authorization
string
header
required

API key from the partner cabinet, Tools -> API (https://partners.onlytraffic.com/tools/api): up to 5 named keys per account, each Full or Read-only, ot_partners_ prefix, shown once at creation. Raw value or Bearer form. Read-only keys cannot call the POST endpoints (403 This API key is read-only); expired or revoked keys get 403 Error! Access denied.

Query Parameters

from

Dataset period start — unix timestamp or Y-m-d. Default: 14 days ago. Max range: 366 days.

Example:

"2026-06-01"

to

Dataset period end — unix timestamp or Y-m-d. Default: now (values in the future are clamped to now).

Example:

"2026-07-01"

Response

200 - application/json

Success

status
enum<string>
Available options:
success
data
object

Fans widget data, one panel per pricing model.