#Overview
The affiliate program pays you for the people you bring. This guide is about the technical side: how to build links that are tracked to you, how to show live models on your own website, how to read your numbers by program, and how to be told the moment you earn something.
| Tool | What it is for | Needs a token? |
|---|---|---|
| Tracked links | Send visitors to the site; the visit is counted and credited to you | No |
| Live models feed | Show who is live right now on your own pages (JSON) | No, only your campaign code |
| Statistics API | Read clicks, signups and earnings by day, track word, link type or campaign | Yes |
| Postbacks | The site calls an address on YOUR server each time you earn | No (you choose the address) |
| Embeds and banners | A frame of live models and picture banners, no code needed | No |
#Basics that apply everywhere
- Base address:
https://starvibelive.com. Every path in this guide starts there. - Format: answers are JSON in UTF-8 unless a section says otherwise. Every JSON answer has an
okfield:trueon success,falsewith anerrorword when something is wrong. - Money: always whole cents (an integer) in the store currency, which is
USD.1350means 13.50. Never use floating point for it. - Dates:
YYYY-MM-DD, in the server's time zone. - HTTPS only: the examples use
https. Calls over plainhttpmay be redirected.
#Quick start
- Open Affiliate program in your member account and apply (or sign in if you are already an affiliate).
- On Links, copy your campaign code. It is a short word of up to 8 letters and digits. In every example below it stands in for
YOURCODE. - Put a tracked link on your page, or call the live models feed from your server.
- When you want your numbers in code, open Banners and tools, press Make a new token, and keep the token safe.
#Your code and your token
There are two secrets-ish values, and they are very different:
| Value | What it is | Safe to publish? |
|---|---|---|
| Campaign code | Names one of your campaigns. It sits inside every tracked link. | Yes. It is meant to be public. |
| Statistics token | Proves you are you when you read your own numbers. | No. Treat it like a password. |
You can have several campaigns (for example one per website) and each has its own code. Reports can be split by campaign, so you can see which website earns.
#Making and replacing a token
On Banners and tools press Make a new token. The token is shown once; the site keeps only a fingerprint of it, so it cannot be shown again. If you lose it, make a new one: the old one stops working at once.
#Tracked links
A tracked link counts the visit, remembers you as the person who sent the visitor, and then sends the visitor on to the page you chose. If the visitor later signs up or buys tokens, the earning is credited to you.
/aff.phpAnswers with a redirect (HTTP 302). It never shows an error page.| Name | Type | Needed | What it does |
|---|---|---|---|
c | text | required | Your campaign code. |
tour | text | optional | Where the visitor lands. One of the link types in the table below. Default: home |
track | text | optional | A word of your own (up to 60 characters) that names this link: a page, an ad, a post. It comes back in your reports so you can see which one works. |
room | text | optional | A model's name. Only used when tour is room. |
#Link types (the tour parameter)
| tour | Where the visitor lands | Needs a model name? |
|---|---|---|
home | Home page | No |
join | Home page with the sign-up window open | No |
top | Top Models | No |
reels | Reels (short videos) | No |
tickets | Ticket shows | No |
models | Models wanted: the model sign-up form | No |
room | One model's room (type the model's name) | Yes: add room=ModelName |
random | A random live room | No |
random-f | A random live room: women | No |
random-m | A random live room: men | No |
random-c | A random live room: couples | No |
random-t | A random live room: trans | No |
#Example links
# the visitor lands on the home page
https://starvibelive.com/aff.php?c=YOURCODE
# the sign-up window opens, and this click is tagged "blog-footer"
https://starvibelive.com/aff.php?c=YOURCODE&tour=join&track=blog-footer
# one model's room
https://starvibelive.com/aff.php?c=YOURCODE&tour=room&room=SampleModel&track=twitter
# check what the link answers (a 302 and where it goes)
curl -sI "https://starvibelive.com/aff.php?c=YOURCODE&tour=top" | grep -i '^location'<?php
// Build a link safely: let PHP encode the values.
function affLink(string $tour = 'home', string $track = '', string $room = ''): string {
$q = ['c' => 'YOURCODE', 'tour' => $tour];
if ($track !== '') { $q['track'] = $track; }
if ($room !== '') { $q['room'] = $room; }
return 'https://starvibelive.com/aff.php?' . http_build_query($q);
}
echo affLink('room', 'newsletter-may', 'SampleModel');// Build a link safely: let URLSearchParams encode the values.
function affLink(tour = 'home', track = '', room = '') {
const q = new URLSearchParams({ c: 'YOURCODE', tour });
if (track) q.set('track', track);
if (room) q.set('room', room);
return 'https://starvibelive.com/aff.php?' + q;
}
document.querySelector('#join-button').href = affLink('join', 'landing-page');from urllib.parse import urlencode
def aff_link(tour='home', track='', room=''):
q = {'c': 'YOURCODE', 'tour': tour}
if track:
q['track'] = track
if room:
q['room'] = room
return 'https://starvibelive.com/aff.php?' + urlencode(q)
print(aff_link('room', 'newsletter-may', 'SampleModel'))#How a click is counted
- A click is counted once per visitor address every 10 seconds, so refreshing does not inflate your numbers.
- A click becomes engaged when the visitor then stays on the site or interacts with it. Engaged clicks are your best measure of real traffic.
- The visitor is linked to you for 30 days by a signed cookie that cannot be forged or edited. A signup or purchase inside that window is credited to you.
- The first affiliate link a visitor used is the one that counts for sign-ups; a later link does not take the credit away.
- A link with an unknown or switched-off campaign still sends the visitor to the page you chose. A bad link never shows an error to a visitor.
#Live models feed
Ask for the models who are live right now and show them on your own pages. Each model comes with a picture and a ready-made tracked link, so every click is credited to you with no extra work.
/referral/api/online.phpPublic. Any website may call it from a browser or a server. Answers are cached for one minute.| Name | Type | Needed | What it does |
|---|---|---|---|
c | text | required | Your campaign code. |
gender | text | optional | Only models of one kind: female, male, couple or trans. Leave it out for everybody. Default: everybody |
limit | integer | optional | How many models, from 1 to 48. Default: 12 |
#The answer
{
"ok": true,
"models": [
{
"name": "SampleModel",
"gender": "Female",
"image": "https://starvibelive.com/models/SampleModel/profile-pic/thumb.jpg",
"link": "https://starvibelive.com/aff.php?c=YOURCODE&tour=room&track=cams&room=SampleModel"
}
]
}| Field | Type | Meaning |
|---|---|---|
ok | boolean | true when the call worked. |
models | list | The models who are live now, in random order. Empty when nobody is live. |
models[].name | text | The model's name as shown on the site. |
models[].gender | text | The kind of account, as the model set it (for example Female). |
models[].image | text | A full address of the profile picture, or an empty text when the model has none. |
models[].link | text | Your tracked link to that model's room. Use it as the link target; do not edit it. |
#Examples
curl -s "https://starvibelive.com/referral/api/online.php?c=YOURCODE&gender=female&limit=6"<?php
$url = 'https://starvibelive.com/referral/api/online.php?' . http_build_query(['c' => 'YOURCODE', 'limit' => 8]);
$data = json_decode(file_get_contents($url), true);
if (!$data['ok']) { exit('Feed unavailable: ' . $data['error']); }
foreach ($data['models'] as $m) {
printf("<a href='%s'><img src='%s' alt=''> %s</a>\n",
htmlspecialchars($m['link']), htmlspecialchars($m['image']), htmlspecialchars($m['name']));
}const res = await fetch('https://starvibelive.com/referral/api/online.php?c=YOURCODE&limit=8');
const data = await res.json();
if (!data.ok) throw new Error(data.error);
const list = document.querySelector('#live-now');
for (const m of data.models) {
const a = document.createElement('a');
a.href = m.link; // already your tracked link
a.textContent = m.name; // textContent, never innerHTML, for names
list.append(a);
}import requests
r = requests.get('https://starvibelive.com/referral/api/online.php', params={'c': 'YOURCODE', 'limit': 8}, timeout=10)
data = r.json()
if not data['ok']:
raise SystemExit('Feed unavailable: ' + data['error'])
for m in data['models']:
print(m['name'], m['link'])| Answer | HTTP | What it means |
|---|---|---|
{"ok":false,"error":"unknown_campaign"} | 404 | The code does not exist, the campaign is switched off, or the affiliate program is closed. |
#Statistics API
Read your own numbers: clicks, engaged clicks, signups, recruited models, what the people you brought spent, and what you earned. Group them by day, by your track words, by link type or by campaign, for any range of days.
/referral/api/stats.phpNeeds your account name and your statistics token. Never cached.| Name | Type | Needed | What it does |
|---|---|---|---|
username | text | required | Your account name on the site. |
token | text | required | Your statistics token (see Your code and your token). |
from | date | optional | First day of the range, YYYY-MM-DD. Default: 29 days ago |
to | date | optional | Last day of the range, YYYY-MM-DD. If it is before from, the two are swapped. Default: today |
by | text | optional | How rows are grouped: date, sub (your track words), tour (link types) or campaign. Default: date |
#The answer
{
"ok": true,
"currency": "USD",
"rows": [
{
"key": "2026-10-22",
"raw": 120,
"engaged": 87,
"signups": 6,
"t1": 4,
"t2": 1,
"t3": 1,
"bounties": 0,
"spent": 4500,
"earned": 1350
}
],
"total": {
"raw": 120, "engaged": 87, "signups": 6, "t1": 4, "t2": 1, "t3": 1,
"bounties": 0, "spent": 4500, "earned": 1350
},
"from": "2026-10-01",
"to": "2026-10-31",
"by": "date"
}| Field | Type | Meaning |
|---|---|---|
currency | text | The currency of every money field. |
rows | list | One row per day, track word, link type or campaign, depending on by, sorted by key. |
rows[].key | text | What the row stands for: a date, a track word, a link type or a campaign name. |
raw | integer | Clicks counted on your links. |
engaged | integer | Clicks whose visitor then stayed or interacted. |
signups | integer | Free signups credited to you. |
t1, t2, t3 | integer | Of those signups, how many came from countries in tier 1, 2 and 3 (the tiers decide the pay per signup). |
bounties | integer | Models you recruited who reached the earning goal. |
spent | integer (cents) | What the members you brought spent on tokens, after tax. |
earned | integer (cents) | What you earned in the range. It counts earnings that are still waiting to be paid out, and leaves out earnings held for review or reversed. |
total | object | The same fields added up over all rows. |
from, to, by | text | The range and grouping that were used (your inputs, cleaned up). |
#Examples
curl -s "https://starvibelive.com/referral/api/stats.php?username=YOURNAME&token=YOURTOKEN&from=2026-10-01&to=2026-10-31&by=sub"<?php
// Run this on YOUR server. Keep the token in a config file, not in the page.
$token = getenv('AFF_TOKEN');
$url = 'https://starvibelive.com/referral/api/stats.php?' . http_build_query([
'username' => 'YOURNAME', 'token' => $token,
'from' => '2026-10-01', 'to' => '2026-10-31', 'by' => 'date',
]);
$data = json_decode(file_get_contents($url), true);
if (!$data['ok']) { exit('Error: ' . $data['error']); }
foreach ($data['rows'] as $r) {
printf("%s clicks %d signups %d earned %.2f %s\n", $r['key'], $r['raw'], $r['signups'], $r['earned'] / 100, $data['currency']);
}// Node 18+, on your server
const params = new URLSearchParams({
username: 'YOURNAME', token: process.env.AFF_TOKEN,
from: '2026-10-01', to: '2026-10-31', by: 'date',
});
const res = await fetch('https://starvibelive.com/referral/api/stats.php?' + params);
const data = await res.json();
if (!data.ok) throw new Error(data.error);
for (const r of data.rows) {
console.log(r.key, r.raw, r.signups, (r.earned / 100).toFixed(2), data.currency);
}import os, requests
r = requests.get('https://starvibelive.com/referral/api/stats.php', params={
'username': 'YOURNAME', 'token': os.environ['AFF_TOKEN'],
'from': '2026-10-01', 'to': '2026-10-31', 'by': 'date',
}, timeout=15)
data = r.json()
if not data['ok']:
raise SystemExit('Error: ' + data['error'])
for row in data['rows']:
print(row['key'], row['raw'], row['signups'], row['earned'] / 100, data['currency'])#Limits and errors
To stop guessing, a wrong name and a wrong token get exactly the same answer, and an address may make at most 60 calls an hour. A report is a few rows, so one call every few minutes is plenty.
| Answer | HTTP | What it means |
|---|---|---|
{"ok":false,"error":"bad_credentials"} | 403 | The name or the token is wrong, or the token was replaced. Both give this same answer on purpose. |
{"ok":false,"error":"slow_down"} | 429 | More than 60 calls in an hour from your address. Wait and try again. |
#Postbacks
A postback turns things around: instead of you asking, the site calls an address on your server every time you earn something. Your own tracking, spreadsheet or ad platform sees each signup and sale as it happens.
#Setting one up
- Open Postbacks in your affiliate area and add an address that starts with
https://. - Put placeholders in the address where you want the details, for example
https://you.example/hook?event={event}&amount={amount}&sub={sub}&id={id}. They are replaced before the call. - Choose which events you want, or everything.
- Press Test to send a sample call and see what your server answers.
If your address has no placeholders at all, the usual details are added to it as a query string for you.
#Placeholders
| Placeholder | Filled with |
|---|---|
{event} | What happened: signup, purchase, bounty or level2 (an earning from an affiliate you brought in). A test call uses test. |
{amount} | Your earning, in money with two decimals (for example 13.50). |
{cents} | The same, in whole cents (1350). |
{currency} | The currency, for example USD. |
{sub} | The track word of the link that brought the visitor. |
{tour} | The link type that was used (home, join, room ...). |
{campaign} | Your campaign code. |
{country} | The visitor's country as two letters, when known. |
{tier} | The country tier, 1 to 3, for signups. |
{id} | The number of the earning. It never changes and is unique: use it to ignore a call you already handled. |
{time} | When the earning was made, as a Unix time (seconds). |
{salt} | A secret word of your own for this postback address (you can type one, or one is made for you). See "Checking the call is real". |
#What the site does
- It makes a plain GET request with a short time limit (6 seconds) and does not follow redirects.
- An answer with any 2xx status counts as received. Anything else (or no answer) is tried again after 1 minute, then 10 minutes, then 1 hour, and then given up.
- You can have up to 5 postback addresses. Each shows its recent calls and what your server answered.
- Only the normal web ports (80 and 443) are used, and your address must point to a public server: addresses inside private networks are refused.
- Earnings that are held for review are not sent until they are released.
#Checking the call is real
Anyone can type your postback address into a browser. Put a secret salt in the address (...&salt={salt}) and ignore calls where it does not match the word you chose. Also use {id} to ignore a call you already handled, since a retry can arrive twice.
# Pretend to be the site and test your own endpoint:
curl -i "https://you.example/hook?event=signup&amount=1.50&sub=test&id=1&salt=MYSECRET"<?php
// https://you.example/hook.php
if (($_GET['salt'] ?? '') !== 'MYSECRET') { http_response_code(403); exit; }
$id = (int) ($_GET['id'] ?? 0);
// ... skip it if $id was already stored ...
file_put_contents('sales.log', json_encode($_GET) . "\n", FILE_APPEND);
http_response_code(200);
echo 'ok';// Node, no packages
import http from 'node:http';
http.createServer((req, res) => {
const q = new URL(req.url, 'https://you.example').searchParams;
if (q.get('salt') !== 'MYSECRET') { res.writeHead(403).end(); return; }
console.log(q.get('event'), q.get('amount'), q.get('id'));
res.writeHead(200).end('ok');
}).listen(8080);from flask import Flask, request, abort
app = Flask(__name__)
@app.get('/hook')
def hook():
if request.args.get('salt') != 'MYSECRET':
abort(403)
print(request.args.get('event'), request.args.get('amount'), request.args.get('id'))
return 'ok', 200#Embeds and banners
No programming needed: paste a few lines of HTML.
#A frame of live models
/referral/embed.phpA small page made to sit inside an iframe. It uses no script and sets no cookies.| Name | Type | Needed | What it does |
|---|---|---|---|
c | text | required | Your campaign code. |
gender | text | optional | female, male, couple or trans. Default: everybody |
n | integer | optional | How many models, 1 to 48. Default: 8 |
bg | hex colour | optional | Background colour as six hex digits without #, for example 111111. Default: 111111 |
fg | hex colour | optional | Text colour, same format. Default: ffffff |
<?php // the same frame, printed from PHP
echo '<iframe src="https://starvibelive.com/referral/embed.php?c=YOURCODE&n=8" width="100%" height="420" style="border:0" loading="lazy" title="Live models"></iframe>';<iframe src="https://starvibelive.com/referral/embed.php?c=YOURCODE&n=8&bg=101010&fg=ffffff"
width="100%" height="420" style="border:0" loading="lazy"
title="Live models"></iframe>Every model in the frame links through your tracked link. An invalid colour is ignored, and the frame says so politely when nobody is live.
#Banners
Picture banners are made by the site team and listed on Banners and tools with the ready-to-paste code for each one. A banner file is served from https://starvibelive.com/referral/banner.php?id=NUMBER and may be hot-linked from your pages. Only active banners are served.
#RSS feed of live models
/referral/rss.phpPublic RSS 2.0 for feed readers, auto-posting tools and websites that show feeds. Cached for one minute.| Name | Type | Needed | What it does |
|---|---|---|---|
c | text | required | Your campaign code. |
gender | text | optional | female, male, couple or trans. Default: everybody |
limit | integer | optional | How many models, 1 to 48. Default: 20 |
Each item is a model who is live now: the title says so, the link is your tracked link to the room (with the track word rss), and the description carries the picture. An unknown or paused campaign gets a 404.
#Popup link
/referral/popup.phpA script for your own website: on the visitor's first click anywhere on your page your tracked link opens in a new window, then not again on that browser for the hours you set.| Name | Type | Needed | What it does |
|---|---|---|---|
c | text | required | Your campaign code. |
hours | integer | optional | How long before the same browser gets it again, 1 to 168. Default: 24 |
tour | text | optional | Where the link goes: any tour that needs no model name (see Tracked links), for example join. Default: home |
<script src="https://starvibelive.com/referral/popup.php?c=YOURCODE&hours=24" async></script>Nothing opens without a click (browsers block that anyway), and the track word is popup, so you can see these visits apart in your statistics.
#Pre-roll video ad (VAST)
/referral/vast.phpA VAST 3.0 answer for any video player that plays ads (Video.js, JW Player, Flowplayer ...). Never cached.| Name | Type | Needed | What it does |
|---|---|---|---|
c | text | required | Your campaign code. |
gender | text | optional | female, male, couple or trans. Default: everybody |
One linear ad: the teaser clip of a model (one who is live now first), skippable after 5 seconds; a click opens your tracked link to that model's room with the track word preroll. When no model has a teaser the answer is an empty <VAST version="3.0"/> and the player plays no ad. An unknown or paused campaign gets a 404.
#Errors, limits and good habits
| Call | Limit |
|---|---|
| Live models feed | Cached for 1 minute. Between 1 and 48 models per call. |
| Statistics API | 60 calls an hour per address. |
| Postbacks | Up to 5 addresses; 3 retries (1 minute, 10 minutes, 1 hour). |
| Tracked links | One counted click per visitor address every 10 seconds. |
#Answers you can get
| Answer | HTTP | What it means |
|---|---|---|
{"ok":false,"error":"unknown_campaign"} | 404 | Feed: the campaign code is not active. |
{"ok":false,"error":"bad_credentials"} | 403 | Statistics: wrong name or token. |
{"ok":false,"error":"slow_down"} | 429 | Statistics: too many calls this hour. |
(redirect) | 302 | Tracked links always redirect, even when something is wrong with the link. |
#Good habits
- Check the
okfield before you use anything else in an answer. - Treat money as integers in cents all the way to the screen.
- Escape model names when you put them into a page (use
textContentorhtmlspecialchars). - Keep your token on a server, in an environment variable or a config file that is not public.
- Cache the feed for a minute, and cache your statistics for a few minutes.
- Use
trackwords on every link. They cost nothing and show you what works.
#Earnings and payouts
A short note on when the money is yours, so the numbers in your reports make sense.
- A new earning waits 90 days (time for refunds and chargebacks) before it can be paid out.
- You can ask for a payout from $10.00. Everything available goes into one payout.
- If a purchase you were paid for is refunded, that earning is reversed. If it was already paid out, it is taken off a later payout.
- The numbers in the Statistics API are your earnings by the day they were made, not by the day they are paid. The Payouts page shows what is paid.
Documentation