Skip to main content
GET
Conversion statistics
How engaged the fans you bring in are, split by pricing model. This is the same data as the Conversion widget in the partner dashboard. The response has three panels: total, revshare and cpl. Each panel contains: Each dataset entry has total_count (fans who subscribed that day), message_count (how many of them sent 3 or more messages) and conversion (message_count / total_count × 100, in %).

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.
CPL campaigns that run on a shared link (limited access) aren’t included, because there’s no per-subscriber data for them. That’s why total_fans here can be lower than count in Fans Stats.
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

Conversion widget data, one panel per pricing model. Shared-link campaigns are excluded.