> ## Documentation Index
> Fetch the complete documentation index at: https://onlytraffic.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Conversion Stats
> Subscriber-quality metrics per pricing model: total fans, fans with 3+ messages, fans with at least one purchase, ARPU — plus a daily conversion dataset (share of fans with 3+ messages).
Shared-link (limited access) CPL campaigns are excluded — no per-subscriber data exists for them.
Cached for 15 minutes.
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:
| Field | Description |
| ------------ | -------------------------------------------------- |
| `total_fans` | All-time fans |
| `messages` | Fans who sent 3 or more messages |
| `purchase` | Fans who made at least one purchase |
| `arpu` | All-time average revenue per fan |
| `dataset` | Day-by-day conversion for the `from` / `to` period |
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](/docs/partners/api/stats-fans).
Responses are cached for 15 minutes.
## OpenAPI
````yaml api/openapi-partners.json GET /api/marketer/stats/conversion
openapi: 3.0.2
info:
title: OnlyTraffic Marketer API
version: 2.0.0
description: >-
Partner (marketer) API for OnlyTraffic.
**Authentication:** pass your API key in the `Authorization` header.
**Pagination:** all list endpoints accept `offset` (default 0) and `limit`
(default 50, max 1000) as query parameters or JSON body fields.
**Dates:** every timestamp field has two variants — an ISO 8601 string
(`*_at`) and a Unix timestamp integer (`*_at_ts` / `*_ts`).
**Legacy endpoints** (`?do=…`) are still available for backward
compatibility but are not extended further.
servers:
- url: https://partner.onlytraffic.com
security: []
tags:
- name: RevShare
description: RevShare campaigns and financial data
- name: CPL
description: Cost-Per-Lead orders placed against your offers
- name: CPC
description: Cost-Per-Click orders
- name: Subscribers
description: Fans acquired through your campaigns
- name: Stats
description: Dashboard-style statistics widgets (fans, income, conversion)
- name: Legacy
description: Old `?do=` endpoints kept for backward compatibility
paths:
/api/marketer/stats/conversion:
get:
tags:
- Stats
summary: Conversion statistics
description: >-
Subscriber-quality metrics per pricing model: total fans, fans with 3+
messages, fans with at least one purchase, ARPU — plus a daily
conversion dataset (share of fans with 3+ messages).
Shared-link (limited access) CPL campaigns are excluded — no
per-subscriber data exists for them.
Cached for 15 minutes.
parameters:
- $ref: '#/components/parameters/stats_from'
- $ref: '#/components/parameters/stats_to'
responses:
'200':
description: Success
content:
application/json:
schema:
oneOf:
- title: Success
type: object
properties:
status:
type: string
enum:
- success
data:
$ref: '#/components/schemas/StatsConversion'
- $ref: '#/components/schemas/ErrorResponse'
example:
status: success
data:
total:
total_fans: 6598
messages: 1420
purchase: 980
arpu: 3.254
dataset:
- date: '2026-07-16'
message_count: 21
total_count: 139
conversion: 15.11
label: Total
revshare:
total_fans: 4936
messages: 1100
purchase: 760
arpu: 3.87
dataset:
- date: '2026-07-16'
message_count: 8
total_count: 40
conversion: 20
label: RevShare
cpl:
total_fans: 1662
messages: 320
purchase: 220
arpu: 1.98
dataset:
- date: '2026-07-16'
message_count: 13
total_count: 99
conversion: 13.13
label: CPL
security:
- api_key: []
components:
parameters:
stats_from:
name: from
in: query
schema:
oneOf:
- type: integer
- type: string
format: date
example: '2026-06-01'
description: >-
Dataset period start — unix timestamp or Y-m-d. Default: 14 days ago.
Max range: 366 days.
stats_to:
name: to
in: query
schema:
oneOf:
- type: integer
- type: string
format: date
example: '2026-07-01'
description: >-
Dataset period end — unix timestamp or Y-m-d. Default: now (values in
the future are clamped to now).
schemas:
StatsConversion:
type: object
description: >-
Conversion widget data, one panel per pricing model. Shared-link
campaigns are excluded.
properties:
total:
$ref: '#/components/schemas/StatsConversionPanel'
revshare:
$ref: '#/components/schemas/StatsConversionPanel'
cpl:
$ref: '#/components/schemas/StatsConversionPanel'
ErrorResponse:
title: Error
type: object
properties:
status:
type: string
enum:
- error
message:
type: string
description: Human-readable error description.
error_code:
type: integer
description: '422: bad request params. 404: not found. 429: rate limit exceeded.'
StatsConversionPanel:
type: object
properties:
total_fans:
type: integer
description: All-time fans count (shared-link campaigns excluded).
messages:
type: integer
description: Fans who sent 3+ messages.
purchase:
type: integer
description: Fans with at least one purchase.
arpu:
type: number
description: Average revenue per fan, all-time.
dataset:
type: array
description: One entry per day of the requested period.
items:
type: object
properties:
date:
type: string
format: date
message_count:
type: integer
description: Fans subscribed this day who sent 3+ messages.
total_count:
type: integer
description: Fans subscribed this day.
conversion:
type: number
description: message_count / total_count × 100, %.
label:
type: string
securitySchemes:
api_key:
type: apiKey
name: Authorization
in: header
````