> ## 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.

# Fans Stats

> Acquired-fans counters per pricing model — all-time (`count`), last 30 days (`monthly`, fixed window regardless of `from`/`to`), over the requested period (`period_sum`) — plus a daily dataset.

Shared-link (limited access) CPL campaigns are included: their fans are counted from daily parser snapshots.

Cached for 15 minutes.

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:

| Field        | Description                                                              |
| ------------ | ------------------------------------------------------------------------ |
| `count`      | All-time fans                                                            |
| `monthly`    | Fans in the last 30 days. This window is fixed and ignores `from` / `to` |
| `period_sum` | Fans over the `from` / `to` period                                       |
| `dataset`    | Day-by-day fan counts for the `from` / `to` period, ready to plot        |

## 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.

<Note>
  The numbers include CPL campaigns that run on a shared link (limited access). Fans for those campaigns are counted from daily account snapshots.
</Note>

<Info>Responses are cached for 15 minutes.</Info>


## OpenAPI

````yaml api/openapi-partners.json GET /api/marketer/stats/fans
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/fans:
    get:
      tags:
        - Stats
      summary: Fans statistics
      description: >-
        Acquired-fans counters per pricing model — all-time (`count`), last 30
        days (`monthly`, fixed window regardless of `from`/`to`), over the
        requested period (`period_sum`) — plus a daily dataset.


        Shared-link (limited access) CPL campaigns are included: their fans are
        counted from daily parser snapshots.


        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/StatsFans'
                  - $ref: '#/components/schemas/ErrorResponse'
              example:
                status: success
                data:
                  total:
                    count: 11534
                    monthly: 2612
                    period_sum: 1258
                    dataset:
                      - date: '2026-07-15'
                        count: 38
                      - date: '2026-07-16'
                        count: 139
                    label: Total
                  revshare:
                    count: 4936
                    monthly: 720
                    period_sum: 310
                    dataset:
                      - date: '2026-07-15'
                        count: 12
                      - date: '2026-07-16'
                        count: 40
                    label: RevShare
                  cpl:
                    count: 6598
                    monthly: 1892
                    period_sum: 948
                    dataset:
                      - date: '2026-07-15'
                        count: 26
                      - date: '2026-07-16'
                        count: 99
                    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:
    StatsFans:
      type: object
      description: Fans widget data, one panel per pricing model.
      properties:
        total:
          $ref: '#/components/schemas/StatsFansPanel'
        revshare:
          $ref: '#/components/schemas/StatsFansPanel'
        cpl:
          $ref: '#/components/schemas/StatsFansPanel'
    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.'
    StatsFansPanel:
      type: object
      properties:
        count:
          type: integer
          description: All-time fans count.
        monthly:
          type: integer
          description: Fans acquired in the last 30 days (fixed window).
        period_sum:
          type: integer
          description: Fans acquired over the requested from/to period.
        dataset:
          type: array
          description: One entry per day of the requested period.
          items:
            type: object
            properties:
              date:
                type: string
                format: date
              count:
                type: integer
        label:
          type: string
  securitySchemes:
    api_key:
      type: apiKey
      name: Authorization
      in: header

````