Start a RevShare campaign

curl --request POST \
  --url https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "of_account_id": 456789,
  "source": "telegram",
  "type": "1",
  "note": "Telegram channel test"
}
'

import requests

url = "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start"

payload = {
    "of_account_id": 456789,
    "source": "telegram",
    "type": "1",
    "note": "Telegram channel test"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    of_account_id: 456789,
    source: 'telegram',
    type: '1',
    note: 'Telegram channel test'
  })
};

fetch('https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'of_account_id' => 456789,
    'source' => 'telegram',
    'type' => '1',
    'note' => 'Telegram channel test'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start"

	payload := strings.NewReader("{\n  \"of_account_id\": 456789,\n  \"source\": \"telegram\",\n  \"type\": \"1\",\n  \"note\": \"Telegram channel test\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"of_account_id\": 456789,\n  \"source\": \"telegram\",\n  \"type\": \"1\",\n  \"note\": \"Telegram channel test\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"of_account_id\": 456789,\n  \"source\": \"telegram\",\n  \"type\": \"1\",\n  \"note\": \"Telegram channel test\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "campaign_id": "revc_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
  }
}

Запись

Запустить RevShare-кампанию

Starts a RevShare campaign on a model from the offer catalog (/api/marketer/revshare/offers). Same fields, defaults and rules as the Start modal in the cabinet: campaign limits, cooldowns and per-model source restrictions come back as error messages.

Returns the created campaign as one /api/marketer/revshare/campaigns row.

Errors (status: "error", HTTP 200):

422 Please fill in all campaign fields when of_account_id or source is missing.
4xx Platform limit / cooldown messages (campaign limit reached, source not allowed for this model, cooldown after a finished campaign) pass through unchanged.
429 Another campaign start is still running. Wait a few seconds and try again (one campaign start at a time per account).
403 Access denied: missing / unknown key, or the account is not an active partner.
429 Rate limit exceeded (30 writes per minute per key, see the Retry-After header).
503 Service is temporarily unavailable: the platform did not answer in time. The action may still have been applied, check the matching read endpoint before repeating it.

POST

api

marketer

revshare

campaigns

start

Start a RevShare campaign

curl --request POST \
  --url https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "of_account_id": 456789,
  "source": "telegram",
  "type": "1",
  "note": "Telegram channel test"
}
'

import requests

url = "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start"

payload = {
    "of_account_id": 456789,
    "source": "telegram",
    "type": "1",
    "note": "Telegram channel test"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    of_account_id: 456789,
    source: 'telegram',
    type: '1',
    note: 'Telegram channel test'
  })
};

fetch('https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'of_account_id' => 456789,
    'source' => 'telegram',
    'type' => '1',
    'note' => 'Telegram channel test'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start"

	payload := strings.NewReader("{\n  \"of_account_id\": 456789,\n  \"source\": \"telegram\",\n  \"type\": \"1\",\n  \"note\": \"Telegram channel test\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"of_account_id\": 456789,\n  \"source\": \"telegram\",\n  \"type\": \"1\",\n  \"note\": \"Telegram channel test\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://partners.onlytraffic.com/api/marketer/revshare/campaigns/start")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"of_account_id\": 456789,\n  \"source\": \"telegram\",\n  \"type\": \"1\",\n  \"note\": \"Telegram channel test\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "campaign_id": "revc_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
  }
}

То же, что Start на RevShare-оффере в кабинете. Выберите модель из /api/marketer/revshare/offers и передайте её of_account_id.

Поля

Поле	Описание
`of_account_id`	Id аккаунта OnlyFans модели из каталога офферов
`source`	Slug источника трафика, те же значения, что предлагает веб-форма Start (например, `telegram`, `instagram`, `tiktok`, `reddit`, `x`). Источники, которые модель исключила, отклоняются
`type`	Код типа кампании, который отправляет веб-форма Start: `1` By Campaign Link (по умолчанию), `2` Free Trial, только если оффер разрешает trial
`trial_days`	Только для trial-кампаний. По умолчанию 7; тот же набор, что в веб-форме: 1, 3, 7, 14, 30, 90, с ограничением тем, что разрешает модель
`note`	Необязательная приватная заметка

Ошибки

Сообщение	Значение
`Please fill in all campaign fields`	Не передан `of_account_id` или `source` (`422`)
Текст о лимите / кулдауне	Собственное сообщение платформы: достигнут лимит кампаний, кулдаун после завершённой кампании, источник не разрешён (`4xx`)
`Another campaign start is still running. Wait a few seconds and try again`	Один запуск за раз на аккаунт (`429`), повторите через несколько секунд

Перед запуском проверьте available_campaigns_limit в эндпоинте офферов: null означает без ограничений, 0 означает, что ни один запуск не пройдёт.

Авторизации

Authorization

string

header

обязательно

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.

Тело

application/json

of_account_id

integer

обязательно

OnlyFans account numeric id (of_account_id of the offer).

source

string

обязательно

Traffic source slug, the same values the web Start form offers (for example telegram, instagram, tiktok, reddit, x).

type

string

по умолчанию:1

Campaign type code, the same values the web Start form sends: 1 = By Campaign Link, 2 = Free Trial (only when the offer allows trials).

trial_days

integer

по умолчанию:7

Trial length in days, trial campaigns (type = 2) only. Same set as the web Start form: 1, 3, 7, 14, 30, 90, capped by the trial length the model allows.

note

string

Private note shown on the campaign.

Ответ

200 - application/json

Success (check status; errors are also HTTP 200)

Success
Error

status

enum<string>

Доступные опции:

success

data

object

Show child attributes

Обзор

Платформы

Форматы работы

Выплаты и безопасность

API

Запустить RevShare-кампанию

Поля

Ошибки

Авторизации

Тело

Ответ

​Поля

​Ошибки

Авторизации

Тело

Ответ

Поля

Ошибки