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

# RevShare Campaigns

> Returns your RevShare campaigns ordered by creation date descending.

Filters can be passed as query parameters or as a JSON body.



## OpenAPI

````yaml api/openapi-partners.json GET /api/marketer/revshare/campaigns
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`).
servers:
  - url: https://%CURRENT_HOST%
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
paths:
  /api/marketer/revshare/campaigns:
    get:
      tags:
        - RevShare
      summary: List RevShare campaigns
      description: |-
        Returns your RevShare campaigns ordered by creation date descending.

        Filters can be passed as query parameters or as a JSON body.
      parameters:
        - $ref: '#/components/parameters/offset'
        - $ref: '#/components/parameters/limit'
        - name: of_account_id
          in: query
          schema:
            type: integer
          description: >-
            Filter by OnlyFans account numeric id. Returns campaigns of any
            status for that account.
        - name: status
          in: query
          schema:
            type: string
            enum:
              - active
              - completed
          description: 'Filter by campaign status. Default: active.'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                oneOf:
                  - title: Success
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - success
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/RevShareCampaign'
                  - $ref: '#/components/schemas/ErrorResponse'
              example:
                status: success
                data:
                  - campaign_id: camp_abc123
                    of_account_id: 456789
                    of_username: modelname
                    name: My RevShare Campaign
                    url: https://onlyfans.com/modelname/c1
                    type: link
                    status: active
                    revshare_percent: 40
                    visits: 1200
                    subscribers: 85
                    subscribers_today: 3
                    income: 542.3
                    income_today: 12.5
                    revenue: 216.92
                    onlyfans_account:
                      name: Model Name
                      username: modelname
                      about: About text
                      tags:
                        - brunette
                      avatar:
                        original: https://cdn.example.com/avatar.jpg
                        thumbnail: https://cdn.example.com/avatar_thumb.jpg
                        thumbnail_640: https://cdn.example.com/avatar_640.jpg
                      demo_content: []
                      regular_price: 9.99
                      promotions: []
                      blocked_countries: []
                      subscribers_count: 3400
                      likes_count: 87000
                      posts_count: 560
                      photos_count: 420
                      videos_count: 140
                      performer_top: 5
                    tags:
                      - test-tag
                    created_at: '2024-01-01T00:00:00+00:00'
                    created_at_ts: 1704067200
                    finished_at: null
                    finished_at_ts: null
                    changed_at: '2024-06-01T12:00:00+00:00'
                    changed_at_ts: 1717243200
      security:
        - api_key: []
components:
  parameters:
    offset:
      name: offset
      in: query
      schema:
        type: integer
        default: 0
        minimum: 0
      description: Number of records to skip.
    limit:
      name: limit
      in: query
      schema:
        type: integer
        default: 50
        minimum: 1
        maximum: 1000
      description: Number of records to return.
  schemas:
    RevShareCampaign:
      type: object
      properties:
        campaign_id:
          type: string
          description: Campaign public id.
        of_account_id:
          type: integer
        of_username:
          type: string
        name:
          type: string
        url:
          type: string
          format: uri
          nullable: true
          description: Active OnlyFans campaign/trial URL.
        type:
          type: string
          enum:
            - date
            - link
            - trial
            - smartlink
            - smartlink_trial
            - smartlink_tracking
            - shared_link
            - shared_trial
            - unknown
        status:
          type: string
          enum:
            - active
            - completed
        revshare_percent:
          type: number
          description: Your revenue share percentage.
        visits:
          type: integer
          description: Total click/visit count from the tracking stats.
        subscribers:
          type: integer
          description: Total subscribers acquired.
        subscribers_today:
          type: integer
        income:
          type: number
          description: Your total earned income across all time.
        income_today:
          type: number
        revenue:
          type: number
          description: Total subscriber revenue on OnlyFans today.
        onlyfans_account:
          $ref: '#/components/schemas/OnlyfansAccount'
        tags:
          type: array
          items:
            type: string
        created_at:
          type: string
          format: date-time
        created_at_ts:
          type: integer
        finished_at:
          type: string
          format: date-time
          nullable: true
        finished_at_ts:
          type: integer
          nullable: true
        changed_at:
          type: string
          format: date-time
        changed_at_ts:
          type: integer
    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.'
    OnlyfansAccount:
      type: object
      description: Cached snapshot of the OnlyFans model profile.
      properties:
        name:
          type: string
        username:
          type: string
        about:
          type: string
        tags:
          type: array
          items:
            type: string
        avatar:
          type: object
          properties:
            original:
              type: string
              format: uri
            thumbnail:
              type: string
              format: uri
            thumbnail_640:
              type: string
              format: uri
        demo_content:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                  - photo
                  - video
              url:
                type: string
                format: uri
              thumbnail:
                type: string
                format: uri
        regular_price:
          type: number
        promotions:
          type: array
        blocked_countries:
          type: array
          items:
            type: string
        subscribers_count:
          type: integer
        likes_count:
          type: integer
        posts_count:
          type: integer
        photos_count:
          type: integer
        videos_count:
          type: integer
        performer_top:
          type: number
          description: Top percentage among all performers (e.g. 5 = top 5%).
  securitySchemes:
    api_key:
      type: apiKey
      name: Authorization
      in: header

````