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
  }
}

Write

Start RevShare Campaign

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
  }
}

Same as Start on a RevShare offer in the cabinet. Pick the model from /api/marketer/revshare/offers and pass its of_account_id.

Fields

Field	Description
`of_account_id`	The model’s OnlyFans account id from the offer catalog
`source`	Traffic source slug, the same values the web Start form offers (e.g. `telegram`, `instagram`, `tiktok`, `reddit`, `x`). Sources the model excludes are rejected
`type`	Campaign type code the web Start form sends: `1` By Campaign Link (default), `2` Free Trial, only when the offer allows trials
`trial_days`	Trial campaigns only. Default 7; same set as the web form: 1, 3, 7, 14, 30, 90, capped by what the model allows
`note`	Optional private note

Errors

Message	Meaning
`Please fill in all campaign fields`	`of_account_id` or `source` missing (`422`)
Limit / cooldown text	The platform’s own message: campaign limit reached, cooldown after a finished campaign, source not allowed (`4xx`)
`Another campaign start is still running. Wait a few seconds and try again`	One start at a time per account (`429`), retry after a few seconds

Check available_campaigns_limit on the offers endpoint before starting: null means unlimited, 0 means no start will go through.

Authorizations

Authorization

string

header

required

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.

Body

application/json

of_account_id

integer

required

OnlyFans account numeric id (of_account_id of the offer).

source

string

required

Traffic source: a slug the web Start form offers (for example telegram, instagram, tiktok, reddit, facebook, google, threads; X is twitter) or your own label of at least 2 characters, without URLs. Per-model source restrictions compare these slugs, so use twitter for X, never x.

type

string

default: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

default: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.

Response

200 - application/json

Success (check status; errors are also HTTP 200)

Success
Error

status

enum<string>

Available options:

success

data

object

Show child attributes

Overview

Platforms

Work Formats

Payments & Safety

API

Start RevShare Campaign

Fields

Errors

Authorizations

Body

Response