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

# CPC-заказы

> Your CPC (pay-per-click) orders. Default filter: active orders only. Pass `status` to override.



## OpenAPI

````yaml api/openapi-partners.json GET /api/marketer/cpc/orders
openapi: 3.0.2
info:
  title: OnlyTraffic Marketer API
  version: 2.1.0
  description: >-
    Partner (marketer) API for OnlyTraffic.


    **Authentication:** pass your API key in the `Authorization` header
    (`Authorization: your-api-key` or `Authorization: Bearer your-api-key`).
    Create keys in the partner cabinet: Tools -> API
    (https://partners.onlytraffic.com/tools/api). Up to 5 named keys per
    account, each **Full** or **Read-only**, with an optional expiry. Keys start
    with `ot_partners_` and are shown once, at creation. Read-only keys cannot
    call the `POST` endpoints (`error_code` 403, message `This API key is
    read-only`). An older legacy key keeps working with full access until you
    delete it on the same page.


    **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`).


    **Writes:** a Full-access key reads and writes. Write endpoints are `POST`
    with a JSON body, accept public ids only (`revc_…`, `cplo_…`) and answer
    with the updated object in `data`. Rate limit: 120 requests per minute for
    reads, 30 per minute for writes, per account (shared by all its keys).
servers:
  - url: https://partners.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 and the category catalog
  - name: Subscribers
    description: Fans acquired through your campaigns
  - name: Stats
    description: Dashboard-style statistics widgets (fans, income, conversion)
  - name: Write
    description: >-
      Write API: start / stop / update campaigns and accept / reject / stop CPL
      campaigns (same key, same rules as the cabinet)
paths:
  /api/marketer/cpc/orders:
    get:
      tags:
        - CPC
      summary: List CPC orders
      description: >-
        Your CPC (pay-per-click) orders. Default filter: active orders only.
        Pass `status` to override.
      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 (resolved via creative).
        - name: creative_public_id
          in: query
          schema:
            type: string
          description: Filter by creative public_id.
        - name: status
          in: query
          schema:
            type: string
            enum:
              - waiting
              - active
              - rejected
              - completed
          description: 'Filter by order 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/CpcOrder'
                  - $ref: '#/components/schemas/ErrorResponse'
              example:
                status: success
                data:
                  - order_id: ppco_abc123
                    of_account_id: 456789
                    creative:
                      of_account_id: 456789
                      public_id: cre_abc123
                      uuid: 550e8400-e29b-41d4-a716-446655440000
                      name: Model Display Name
                      username: modelname
                      picture: https://cdn.example.com/img_800.webp
                      picture_thumb: https://cdn.example.com/img_200.webp
                      pictures:
                        - full: https://cdn.example.com/img_800.webp
                          thumb: https://cdn.example.com/img_200.webp
                      price: 9.99
                      description: Subscribe for exclusive content
                      categories:
                        - brunette
                        - fitness
                    url: https://tracking.example.com/click/abc123
                    clicks:
                      ordered: 1000
                      delivered: 342
                    price_per_click: 0.05
                    total_earned: 17.1
                    status: active
                    date_start: 1704067200
                    date_finish: null
                    created_at: '2024-01-01T00:00:00+00:00'
                    created_at_ts: 1704067200
      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:
    CpcOrder:
      type: object
      properties:
        order_id:
          type: string
          description: CPC order public id.
        of_account_id:
          type: integer
        creative:
          $ref: '#/components/schemas/Creative'
        url:
          type: string
          format: uri
          description: Tracking URL (Voluum or similar).
        clicks:
          type: object
          properties:
            ordered:
              type: integer
            delivered:
              type: integer
        price_per_click:
          type: number
        total_earned:
          type: number
          description: min(ordered, delivered) × price_per_click.
        status:
          type: string
          enum:
            - waiting
            - active
            - rejected
            - completed
        date_start:
          type: integer
          nullable: true
        date_finish:
          type: integer
          nullable: true
        created_at:
          type: string
          format: date-time
        created_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: >-
            403: access denied (missing / unknown / expired / revoked key, or
            the account is not an active partner: `Error! Access denied`; a
            Read-only key calling a write endpoint: `This API key is
            read-only`). 404: not found. 422: bad request params (message says
            what is wrong). 429: rate limit exceeded (a `Retry-After` header is
            set) or another campaign start is still running. 500: server error.
            503: the platform did not answer a write in time, retry later.
    Creative:
      type: object
      description: CPC creative (model card used in ad placements).
      properties:
        of_account_id:
          type: integer
        public_id:
          type: string
        uuid:
          type: string
          format: uuid
        name:
          type: string
          description: Display name.
        username:
          type: string
          description: OnlyFans username.
        picture:
          type: string
          format: uri
          description: Main image URL (800px).
        picture_thumb:
          type: string
          format: uri
          description: Main image thumbnail (200px).
        pictures:
          type: array
          items:
            type: object
            properties:
              full:
                type: string
                format: uri
              thumb:
                type: string
                format: uri
        price:
          type: number
          description: Subscription price on OnlyFans.
        description:
          type: string
        categories:
          type: array
          items:
            type: string
  securitySchemes:
    api_key:
      type: apiKey
      name: Authorization
      in: header
      description: >-
        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`.

````