igsub.me Free API
100% free — no fees, no paid plans, no API key, no credit card. Free for everyone, forever.
A 100% free (no fees, no paid plans, no API key), public, browser-only JSON API for growing YouTube channels (subscribers, likes, comments, comment likes) and, when enabled, Instagram / TikTok / X / Facebook posts. There is no API key: your web page calls the API directly with fetch() (CORS), the visitor signs in with their own Google account, and every order spends that visitor's free credits. It is the same API our Blogger theme and our own sites use, so you can build a complete site with it: home page with order form, channel page, video page, order tracking page and account page. Every order is protected by hCaptcha.
https://igsub.me directly.Last updated 2026-10-30. Base URL https://igsub.me.
Quick start
Copy this into any page (inside <script type="module">). It signs the visitor in, reads the balance, finds a channel, passes hCaptcha, sends 100 subscribers and tracks the order.
// igsub.me public API — minimal client (no key, browser only)
const API = 'https://igsub.me';
const MY_REF = 'YOURCODE'; // your invite code: +1000 credits for every new user who signs in here
let token = localStorage.getItem('fs_token') || '';
async function api(path, { body, headers = {} } = {}) {
const h = { 'X-FS-Mode': 'token', ...headers };
if (body) h['Content-Type'] = 'application/json';
if (token) h['Authorization'] = 'Bearer ' + token;
const r = await fetch(API + path, {
method: body ? 'POST' : 'GET',
headers: h,
body: body ? JSON.stringify(body) : undefined,
mode: 'cors',
credentials: 'omit',
});
const data = await r.json().catch(() => ({}));
if (r.status === 401 && (data.kod === 'oturum_yok' || data.kod === 'kullanici_yok')) {
token = ''; localStorage.removeItem('fs_token'); // expired -> sign in again
}
return { ok: r.ok, status: r.status, data };
}
// 1) hCaptcha — solved inside an igsub.me frame (no keys on your site)
function captcha() {
return new Promise(resolve => {
const box = document.createElement('div');
box.style.cssText = 'position:fixed;inset:0;background:rgba(0,0,0,.5);display:grid;place-items:center;z-index:9999';
box.innerHTML = '<iframe src="' + API + '/captcha/frame.html" style="width:400px;max-width:95vw;height:560px;border:0;border-radius:12px;background:#fff"></iframe>';
document.body.appendChild(box);
function onMsg(e) {
if (e.origin !== API || !e.data || !e.data.fsCaptcha) return;
window.removeEventListener('message', onMsg); box.remove(); resolve(e.data.fsCaptcha);
}
window.addEventListener('message', onMsg);
box.onclick = e => { if (e.target === box) { window.removeEventListener('message', onMsg); box.remove(); resolve(''); } };
});
}
// 2) Sign in with Google (YouTube TV code)
async function signIn(onCode) {
const ref = new URLSearchParams(location.search).get('ref') || MY_REF;
const s = await api('/api/auth/device/start' + (ref ? '?ref=' + encodeURIComponent(ref) : ''), { body: {} }); // no captcha for sign-in
if (!s.ok) throw new Error(s.data.error);
onCode(s.data.user_code, s.data.qr_url, s.data.qr_image); // show code + link/QR
const until = Date.now() + s.data.expires_in * 1000;
while (Date.now() < until) {
await new Promise(r => setTimeout(r, Math.max(3, s.data.interval) * 1000));
const p = await api('/api/auth/device/poll', { headers: { 'X-FS-Device': s.data.device_token } });
if (p.data.status) { token = p.data.session_token; localStorage.setItem('fs_token', token); return; }
if (['expired', 'no_flow', 'only gmail'].includes(p.data.message)) throw new Error(p.data.message);
}
throw new Error('expired');
}
// 3) Balance
const { data: { kredi } } = await api('/api/kredi'); // kredi.kredi = credits
// 4) Find a channel and order 100 subscribers
const ch = await api('/api/resolve', { body: { q: 'https://www.youtube.com/@channel' } });
const captcha_token = await captcha();
const order = await api('/api/order', { body: { tip: 'sub', hedef_kanal: ch.data.channel_id, adet: 100, captcha_token } });
if (!order.ok) console.log(order.data.kod, order.data.error); // e.g. kredi_yok
// 5) Track it
const timer = setInterval(async () => {
const o = (await api('/api/order/' + order.data.order_id)).data;
console.log(o.status, o.biten_sayac + '/' + o.adet);
if (['completed', 'canceled', 'failed'].includes(o.status)) clearInterval(timer);
}, 10000);
// 6) Games — jackpot pools work without sign-in (poll every 5-15 s)
const jp = (await api('/api/oyun/akis?hafif=1')).data; // { jackpot: [{ ad, carpan, havuz, bolen }], jackpot_son }
jp.jackpot.forEach(j => console.log(j.ad, j.carpan + 'x bet +', j.havuz));
const code = r => r.data.kod || r.data.hata; // yetersiz_kredi / alindi carry the code in "hata"
// coin flip and dice: one request = one hand (bet 10-2000)
let hand = await api('/api/oyun/oyna', { body: { oyun: 'coin', bahis: 100, secim: 'heads' } });
if (hand.ok) console.log(hand.data.sonuc.sonuc, hand.data.sonuc.kazanc, 'balance', hand.data.sonuc.kredi);
else console.log(code(hand)); // yetersiz_kredi, bahis, gecersiz, rate_limit
hand = await api('/api/oyun/oyna', { body: { oyun: 'dice', bahis: 50, hedef: 50 } }); // wins when roll < 50, pays 1.94x
if (hand.ok && hand.data.sonuc.jackpot) console.log('JACKPOT', hand.data.sonuc.jackpot.ad, hand.data.sonuc.jackpot.tutar);
// mines: start, open a cell, cash out (blackjack: basla -> hit / stand / double)
let g = await api('/api/oyun/hamle', { body: { oyun: 'mines', hamle: 'basla', bahis: 100, mayin: 3 } });
g = await api('/api/oyun/hamle', { body: { oyun: 'mines', hamle: 'ac', hucre: 12 } });
if (g.ok && !g.data.durum.bitti) g = await api('/api/oyun/hamle', { body: { oyun: 'mines', hamle: 'nakit' } });
if (g.ok) console.log(g.data.durum.sonuc, g.data.durum.kazanc, g.data.durum.carpan); // cashout 110 1.1 (or lose)
else console.log(code(g)); // oturum_yok_oyun (409) = no open game
// daily streak: +100 ... +2500 credits, once per UTC day
const st = await api('/api/seri/al', { body: {} });
console.log(st.ok ? 'day ' + st.data.seri.seri + ': +' + st.data.seri.kazanilan : code(st)); // 409 alindi = claimed todayRules & headers
- Base URL is always https://igsub.me — every request goes there. All responses are JSON (UTF-8).
- Send the header X-FS-Mode: token on every request and never send cookies (credentials: "omit").
- Without sign-in a visitor can find a channel/video and send 100 free YouTube subscribers once per channel (hCaptcha required). Everything else — likes, comments, other platforms, larger quantities, account, credits, history — requires Google sign-in.
- After sign-in send Authorization: Bearer <session_token> on every request. The token is valid 30 days.
- Browser only: requests must come from a real web page (the browser sends Origin, Sec-Fetch-Mode: cors and an OPTIONS preflight). Server-side calls (PHP, cURL, Python, Node, bots) get 403 browser_required.
- Use POST with Content-Type: application/json for request bodies; unknown body fields are rejected.
- hCaptcha is required for every order (body field captcha_token) and for invite codes and channel credits (header X-FS-Captcha). Sign-in has no captcha. You need no captcha key: show https://igsub.me/captcha/frame.html in an iframe (it opens in the visitor's browser language; add ?hl=xx to force one), the visitor solves it there, and you receive the token via postMessage. One token = one call. Never put any secret in your page; none is needed.
- Errors are { "kod": "<code>", "error": "<English message>", "hata": "<same>" } with a matching HTTP status. Translate on your side by kod.
- The Accept-Language header (sent automatically by browsers) selects the language of YouTube titles/descriptions where available.
- Accounts and credits are shared: a user who signs in on your site has the same account and balance as on igsub.me.
| Header | When | Value |
|---|---|---|
X-FS-Mode | every request | token |
Authorization | after sign-in | Bearer <session_token> |
Content-Type | POST with a body | application/json |
X-FS-Device | only /api/auth/device/poll | <device_token> |
X-FS-Captcha | POST /api/referans/uygula, /api/kredi/kanal-topla | <hCaptcha token> |
fetch options: mode: 'cors', credentials: 'omit'. Origin, User-Agent, Accept-Language and Sec-Fetch-* are added by the browser automatically — do not try to set them.
Sign-in flow
Sign-in uses the YouTube TV device code: the visitor opens youtube.com/qr/activate (or scans a QR code with their phone), signs in with Google and approves. Your page never sees a password.
Visitor Your page (browser) https://igsub.me
| click "Sign in" | |
|------------------>| POST /api/auth/device/start (no captcha)|
| |---------------------------------------->|
| |<-- user_code, qr_url, device_token -----|
|<-- show code -----| |
| opens youtube.com/qr/activate, approves with Google |
| | GET /api/auth/device/poll (every 5s) |
| | X-FS-Device: device_token |
| |---------------------------------------->|
| |<-- { status: true, session_token } -----|
| | save token -> Authorization: Bearer ... |
| paste channel | POST /api/resolve { q } |
| |<-- channel_id, videos ------------------|
| solves hCaptcha | iframe igsub.me/captcha/frame.html |
| |<-- postMessage { fsCaptcha: token } ----|
| click "Send" | POST /api/order { tip, hedef_kanal, adet, captcha_token }
| |<-- order_id, status: queued ------------|
| | GET /api/order/{order_id} (every 10s) |
| |<-- status, biten_sayac / adet ----------|POST /api/auth/device/start(no captcha; optionally?ref=INVITECODE) → showuser_code, a button toqr_urland theqr_image.- Every
intervalseconds:GET /api/auth/device/pollwith headerX-FS-Device: device_token. - When
statusis true, savesession_token(e.g. localStorage) and send it asAuthorization: Bearer. - On next visits call
GET /api/auth/me; a 401 means the token expired — delete it.
Free 100 subscribers (no sign-in)
- Any visitor can send 100 free YouTube subscribers without signing in — no account, no credits, no API key.
- Step 1: POST /api/resolve { "q": "<channel link, @handle or name>" } → channel_id (no Authorization header needed).
- Step 2: show the hCaptcha frame (https://igsub.me/captcha/frame.html) and wait for the token.
- Step 3: POST /api/order { "tip": "sub", "hedef_kanal": "<channel_id>", "captcha_token": "<token>", "fingerprint": "<stable random id>" } → order_id. Quantity is always 100.
- Step 4: GET /api/order/{order_id} every 10 s to show live progress (no sign-in needed).
- Limits: once per channel (lifetime), 1 free order per hour per visitor (IP + fingerprint), 1 free order per hour per channel, and a shared hourly cap for all external sites. When a limit is hit the API answers 401 giris_gerekli or 429 kanal_cooldown — then offer Google sign-in (free credits, every service).
- Only tip "sub" works without sign-in; likes, comments, other platforms and quantities above 100 need sign-in.
// no Authorization header — anonymous visitor
const ch = await api('/api/resolve', { body: { q: 'https://youtube.com/@channel' } });
const captcha_token = await captcha(); // igsub.me hCaptcha frame
let fp = localStorage.getItem('fs_fp');
if (!fp) { fp = crypto.randomUUID(); localStorage.setItem('fs_fp', fp); }
const o = await api('/api/order', { body: { tip: 'sub', hedef_kanal: ch.data.channel_id, captcha_token, fingerprint: fp } });
// o.data.order_id -> GET /api/order/{order_id}; on 401 giris_gerekli / 429 kanal_cooldown offer Google sign-inCredits
- Without sign-in: 100 free YouTube subscribers once per channel (max 1 free order per hour per visitor). No credits needed.
- Credits are free. They are not money and cannot be bought or withdrawn.
- Every signed-in user gets free credits every hour (gunluk_hak, normally 1000) plus a welcome bonus on the first sign-in.
- Each friend who signs in with the user's invite link/code gives +1000 credits. Invite link: https://igsub.me/?ref=<referans_kod> (or pass ref to /api/auth/device/start on your own site).
- Each extra YouTube channel on the user's Google account adds +1000 credits per hour (POST /api/kredi/kanal-topla once per hour).
- An order costs adet × kredi_carpani credits. If dispatch fails, credits are refunded automatically (iade).
- Some services unlock only after a number of invites (min_referans).
Earn credits with your site
Your site can earn free credits for you: add your own invite code and every new user who signs in there counts as your invite.
- Put your own invite code on your site and earn +1000 credits for every new user who signs in there.
- Get your code: sign in on igsub.me (or on your own site) and read referans_kod from GET /api/kredi — it is also shown on the account page.
- Send it with every sign-in (no captcha needed): POST /api/auth/device/start?ref=YOURCODE. In the example page just set window.FS_REF = 'YOURCODE'.
- If a visitor arrives with someone else's invite link (?ref=…), that link wins; otherwise your code is used.
- A user can be invited only once (first invite counts). Limits against abuse: max 30 credited sign-ins per code per day and max 2 per network (IP) per day.
- Spend the credits like any user: orders for your own channels on any of our sites. Credits are free and cannot be sold or withdrawn.
- Your visitors also get their own invite code and link (https://igsub.me/?ref=THEIRCODE) to earn credits themselves.
// sign-in on your site, credited to you POST https://igsub.me/api/auth/device/start?ref=YOURCODE X-FS-Mode: token // example page (starter-kit.html) <script>window.FS_REF = 'YOURCODE';</script>
hCaptcha (required for orders, invites and credits — not for sign-in)
Every POST /api/order needs a fresh captcha_token in the body, and POST /api/referans/uygula and POST /api/kredi/kanal-topla need one in the X-FS-Captcha header. Sign-in (POST /api/auth/device/start) has no captcha. Our hCaptcha site key works only on igsub.me, so the check runs inside a small igsub.me page that you show in an iframe. You never need a captcha key or secret.
- When the visitor clicks “Send”, open a modal with
<iframe src="https://igsub.me/captcha/frame.html">. It opens in the visitor's own browser language automatically; add?hl=tr(any language code) to force one andtheme=darkfor dark mode. Give it about 400×560 px so the challenge fits. - Listen for
messageevents from originhttps://igsub.me. When the visitor passes, you receive{ fsCaptcha: "<token>" }({ fsCaptchaExpired: true }if it expired before use). - Close the modal and send the token:
captcha_tokeninPOST /api/order, or headerX-FS-Captchafor invite / credit calls. A token works once; get a new one for each call. - On
captcha_yok/captcha_retshow the check again.
| Parameter | Description |
|---|---|
hl | Language of the check. Default (omitted or "auto"): the visitor's browser language, so nobody is forced into English. Force one with an hCaptcha language code: en, tr, es, pt, pt-BR, fr, de, it, nl, pl, ru, uk, ar, fa, hi, id, ms, th, vi, ja, ko, zh-CN, zh-TW, ro, cs, el, he, hu, sv, da, fi, no, bg, sr, hr, sk, sl, lt, lv, et and more. Unknown codes fall back to English. |
theme | "dark" for a dark check that matches dark mode; default light. |
<!-- auto language (visitor's browser) --> <iframe src="https://igsub.me/captcha/frame.html"></iframe> <!-- forced Turkish, dark --> <iframe src="https://igsub.me/captcha/frame.html?hl=tr&theme=dark"></iframe>
window.addEventListener('message', (e) => {
if (e.origin !== 'https://igsub.me' || !e.data) return;
if (e.data.fsCaptcha) placeOrder(e.data.fsCaptcha); // -> POST /api/order { ..., captcha_token }
});Games & jackpots
- Signed-in users can play 80+ games with their free credits: single-request games (coin flip, dice, limbo, crash, plinko, wheel, roulette, 12 slot themes, 30 tumble slots, keno, sic bo, baccarat, dragon tiger, horse race, darts, money wheel …), step-by-step games (blackjack, mines, hi-lo, video poker, 14 chain games) plus an hourly wheel, a daily streak, a daily raffle and a weekly tournament.
- Credits are free: they can never be bought, sold or cashed out. Every result is drawn on the server with a crypto RNG and every game returns at most 97% (payout tables in GET /api/oyun), so playing slowly uses credits up — it never creates money.
- Bets are 10–2000 credits per hand. POST /api/oyun/oyna plays one hand in one call; POST /api/oyun/hamle runs step-by-step games (hamle "basla" first, then moves, until durum.bitti is true).
- Jackpots on every game: Grand 500× / Major 150× / Minor 50× / Mini 10× of the bet (bet counted up to 2000) plus a progressive pool that grows with every bet — the whole pool is paid at a bet of 100 or more.
- Weekly tournament (Monday–Sunday UTC): each player's best multiplier on a hand with a bet of at least 100 counts; prizes 25000 / 10000 / 5000 credits for places 1–3 and 1000 for places 4–10, paid automatically.
- Daily streak: 100, 200, 300, 500, 750, 1000 and 2500 credits (day 7), one claim per UTC day; missing a day restarts at day 1.
- Without sign-in your page can show the rules (GET /api/oyun), the live feed and jackpot pools (GET /api/oyun/akis, ?hafif=1 for a ticker) and the tournament (GET /api/oyun/turnuva). Everything else needs the session token.
- Limits: 60 hands per minute and 150 moves per minute per user, plus the usual 90 requests per minute per user for external sites.
- Game pages on igsub.me: https://igsub.me/{lang}/games (lobby) and https://igsub.me/{lang}/games/{key} (e.g. plinko, crash, mines, blackjack, tb-thunder, zn-towers, slots-classic) — link there for the full animated games.
// jackpot ticker — no sign-in
const { jackpot } = (await api('/api/oyun/akis?hafif=1')).data; // [{ ad, carpan, havuz, bolen }]
// one hand (signed in)
const r = await api('/api/oyun/oyna', { body: { oyun: 'dice', bahis: 100, hedef: 50 } });
// r.data.sonuc -> { oyun, bahis, kazanc, net, carpan, deger, kredi, jackpot? }
// step-by-step game
await api('/api/oyun/hamle', { body: { oyun: 'blackjack', hamle: 'basla', bahis: 100 } });
const end = await api('/api/oyun/hamle', { body: { oyun: 'blackjack', hamle: 'stand' } });
// end.data.durum -> { bitti: true, sonuc: 'win' | 'lose' | 'push' | ..., kazanc, kredi }Game catalog
Game page: https://igsub.me/{lang}/games/{page} (lobby https://igsub.me/{lang}/games). single and tumble games use POST /api/oyun/oyna; stateful and chain games use POST /api/oyun/hamle. Exact payout tables: GET /api/oyun.
| Page | oyun | Type | Parameters | Payout / result |
|---|---|---|---|---|
coin | coin | single | secim: heads | tails | 1.94× on a correct call. sonuc = side that landed. |
dice | dice | single | hedef: 2–95 | Roll deger 0.00–99.99; wins when deger < hedef. Pays floor(97 / hedef, 4 decimals)× (hedef 50 → 1.94×, hedef 2 → 48.5×). |
limbo | limbo | single | x: 1.01–1000 | deger = drawn multiplier (P(deger ≥ x) = 0.97 / x); wins x× when deger ≥ x. |
crash | crash | single | x: 1.01–1000 (auto cash-out) | Same math as limbo; deger = crash point. |
plinko | plinko | single | satir: 8 | 12 | 16 · risk: low | medium | high · adet: 1–10 balls | indeks = pocket (number of right bounces), yol = path (0 left, 1 right). Table plinko["<satir><risk>"]; up to 980×. |
wheel | wheel | single | risk: low | medium | high | indeks = slice; table wheel[risk] (high: one 29.1× slice of 30). |
roulette | roulette | single | secim: red | black | even | odd | low | high | dozen1–3 | col1–3 | n:0–n:36 | European wheel (37 pockets). Even-money bets 2×, dozens/columns 3×, single number 36×; 0 loses all outside bets. deger = number, sonuc = green | red | black. |
slots-<theme> | slots | single | secim: theme (12, see slot themes; empty = classic) | sonuc = winning row name (e.g. diamond, seven, jackpot, pair) or "lose"; tables slot / slot_tema. |
scratch | scratch | single | — | sonuc x10 | x5 | x3 | x2 | x1 | lose. |
rps | rps | single | secim: rock | paper | scissors | sonuc / indeks = server hand. Win 1.91×, draw 1× (bet back). |
lucky | lucky | single | hedef: 1–10 | deger = drawn number; 9.7× when equal. |
cups | cups | single | hedef: 1–3 | indeks = cup with the ball; 2.91× when equal. |
baccarat | baccarat | single | secim: player | banker | tie | Player 1.95×, banker 1.90×, tie 9× (player/banker bets returned on a tie). kartlar = [player cards, banker cards], deger = player points, indeks = banker points, sonuc = winner. |
keno | keno | single | secim: 1–10 different numbers 1–40, comma separated | sayilar = 10 drawn numbers, indeks = hits; pays keno[picks][hits] (up to 980×). |
sicbo | sicbo | single | secim: small | big | odd | even | triple_any | triple:N | double:N (N 1–6) | total:4–17 | sayilar = 3 dice, deger = total. small/big/odd/even lose on any triple. Table sicbo (up to 209.52×). |
dragontiger | dragontiger | single | secim: dragon | tiger | tie | One card each (kartlar [[dragon], [tiger]]), higher rank wins. Dragon/tiger 2.10× (lose on a tie), tie 12.61×. |
ou7 | ou7 | single | secim: under | over | seven | sayilar = 2 dice, deger = sum. Under/over 7: 2.32×, exactly 7: 5.82×. |
horse | horse | single | hedef: horse 1–6 | sayilar = finish order, indeks = winner. Pays at[hedef − 1] (3.23× … 16.16×); chances at_olas. |
darts | darts | single | risk: low | medium | high | sonuc = zone (bull, inner, outer, triple, double, single, miss), deger = angle 0–359 for the animation. Table dart[risk]. |
moneywheel | moneywheel | single | secim: "1" | "2" | "5" | "10" | "20" | "40" | indeks = slice of money_dilim (54 slices); pays money_carpan[secim] when that value lands. |
tb-<theme> | tumble | tumble | secim: tumble theme (30, see tumble themes) · bonus: true to buy free spins | tur = TumbleRound (every spin and cascade). Scatter engine (sc-*): 6×5, 8+ of a symbol anywhere pays, multiplier orbs; 4+ scatters → 10 free spins (+5 on 3+ during free spins). Cluster engine (cl-*): 7×7, 5+ connected pay, cell multipliers double on repeat wins; 3+ scatters → 10 free spins. Round cap 5000× bet. |
blackjack | blackjack | stateful | basla (bahis) → hit | stand | double | Infinite deck, dealer hits soft 17, peeks with A/10 up. Win 2×, push 1×, blackjack 2× (pays 1:1), no split, double on the first two cards only. |
mines | mines | stateful | basla (bahis, mayin 1–24) → ac (hucre 0–24) … → nakit | Cash out at 0.97 × 1/P(survive) (3 mines: 1.10×, 1.25×, 1.44× …). Hitting a mine loses; opening every safe cell cashes out automatically. |
hilo | hilo | stateful | basla (bahis) → yuksek | dusuk | atla … → nakit | yuksek = same or higher (strictly higher on an Ace), dusuk = same or lower (strictly lower on a King). Multiplier 0.97 × Π 1/p; p_yuksek / p_dusuk show the chances. atla skips a card for free. |
videopoker | videopoker | stateful | basla (bahis) → cek (tut[5]) | Jacks or Better 7/5: royal_flush 800×, straight_flush 50×, four_kind 25×, full_house 7×, flush 5×, straight 4×, three_kind 3×, two_pair 2×, jacks_better 1×. |
zn-<key> | zn-<key> | chain | basla (bahis, risk) → ac (hucre for "kule" games) … → nakit | 14 chain games (see chain games). After s safe steps: floor(0.97 × (n / k)^s, 2 decimals)×. Reaching max_adim cashes out automatically. |
raffle | — | single | POST /api/cekilis/bilet | Daily raffle: winner gets 97% of all ticket credits. |
| secim | Pays |
|---|---|
classic | classic (top 50×) |
candy | candy (top 10×, low volatility) |
space | space (top 100×) |
gems | gems (top 200×) |
egypt | egypt (top 500×, high volatility) |
lucky7 | pays like classic |
fruitstand | pays like candy |
neon | pays like space |
ocean | pays like gems |
samurai | pays like egypt |
western | pays like space |
royal | pays like gems |
thunder sc-highcandy sc-midfruit sc-lowdragon sc-highocean sc-midcosmic sc-midjungle sc-lowdesert sc-highaztec sc-highviking sc-midsamurai sc-highsafari sc-lowgarden sc-lowcasino sc-midxmas sc-midmonster sc-highsugar cl-middonut cl-lowcrystal cl-highfarm cl-lowneon cl-midfrozen cl-midpirate cl-highspooky cl-highbubble cl-lowtoybox cl-midgemmine cl-highbakery cl-lowarcade cl-midufo cl-high
| oyun | Mode | risk (k of n safe) | Max steps |
|---|---|---|---|
zn-towers | kule — pick hucre 0…n−1 per row | easy 4/3 · medium 3/2 · hard 2/1 · expert 3/1 | 9 |
zn-dragontower | kule — pick hucre 0…n−1 per row | easy 4/3 · medium 3/2 · hard 2/1 · expert 4/1 | 9 |
zn-doors | kule — pick hucre 0…n−1 per row | easy 3/2 · medium 2/1 · hard 3/1 | 10 |
zn-defuse | kule — pick hucre 0…n−1 per row | easy 4/3 · medium 4/2 · hard 4/1 | 8 |
zn-ladder | kule — pick hucre 0…n−1 per row | easy 5/4 · medium 5/3 · hard 5/2 | 12 |
zn-bridge | kule — pick hucre 0…n−1 per row | easy 3/2 · medium 2/1 · hard 3/1 | 10 |
zn-icelake | kule — pick hucre 0…n−1 per row | easy 5/4 · medium 4/2 · hard 5/1 | 10 |
zn-minecart | kule — pick hucre 0…n−1 per row | easy 4/3 · medium 3/2 · hard 2/1 | 10 |
zn-pump | tek — just advance | low 20/19 · medium 10/9 · high 5/4 · extreme 3/2 | 40 |
zn-chicken | tek — just advance | easy 25/24 · medium 12/11 · hard 6/5 · daredevil 3/2 | 30 |
zn-streak | tek — just advance | normal 2/1 | 20 |
zn-penalty | tek — just advance | easy 5/4 · medium 5/3 · hard 5/2 | 10 |
zn-spacejump | tek — just advance | low 10/9 · medium 5/4 · high 3/2 | 25 |
zn-heist | tek — just advance | easy 6/5 · medium 4/3 · hard 2/1 | 15 |
Endpoints
33 endpoints in 8 groups. All paths are relative to https://igsub.me. 🔒 = sign-in required · ◐ = works without sign-in (free 100 subscribers flow, game feed / tournament) · — = public.
| Method | Path | Auth | Purpose |
|---|---|---|---|
| GET | /api/site | — | Site information |
| GET | /api/link-servisler | — | Service catalog |
| POST | /api/auth/device/start | — | Start Google sign-in |
| GET | /api/auth/device/poll | — | Poll sign-in |
| GET | /api/auth/me | 🔒 | Current user |
| POST | /api/auth/logout | — | Sign out |
| GET | /api/kredi | 🔒 | Credit balance |
| GET | /api/kredi/hareketler | 🔒 | Credit history |
| POST | /api/referans/uygula | 🔒 | Apply an invite code |
| POST | /api/kredi/kanal-topla | 🔒 | Claim extra-channel credits |
| POST | /api/resolve | ◐ | Find a channel or video |
| GET | /api/search | 🔒 | Search channels |
| GET | /api/channel/{channelId} | ◐ | Channel page data |
| GET | /api/channel/{channelId}/videos | ◐ | More channel videos / shorts |
| GET | /api/video/{videoId} | ◐ | Video page data |
| POST | /api/order | ◐ | Create an order |
| GET | /api/order/{order_id} | ◐ | Order progress |
| GET | /api/order/{order_id}/events | ◐ | Order timeline |
| GET | /api/siparislerim | 🔒 | My orders |
| GET | /api/siparislerim/{id} | 🔒 | One of my orders |
| GET | /api/son-siparisler | — | Recent deliveries |
| GET | /api/oyun | — | Game rules & payout tables |
| POST | /api/oyun/oyna | 🔒 | Play one hand (single-request games) |
| POST | /api/oyun/hamle | 🔒 | Step-by-step games (start, move, cash out) |
| GET | /api/oyun/oturum | 🔒 | Resume an open game |
| GET | /api/oyun/akis | ◐ | Live feed, statistics & jackpot pools |
| GET | /api/oyun/turnuva | ◐ | Weekly tournament |
| GET | /api/seri | 🔒 | Daily streak status |
| POST | /api/seri/al | 🔒 | Claim today's streak bonus |
| GET | /api/cark | 🔒 | Hourly lucky wheel status |
| POST | /api/cark/cevir | 🔒 | Spin the hourly wheel |
| GET | /api/cekilis | 🔒 | Daily raffle status |
| POST | /api/cekilis/bilet | 🔒 | Buy raffle tickets |
Site & catalog
Public information. No sign-in needed.
Site information
Name, languages and public settings of the API host. Call it once on page load if you want to show the brand or language list.
| Name | Type | Description |
|---|---|---|
domain | string | API host domain. |
ad | string | Brand name. |
varsayilan_dil | string | Default language code. |
diller | string[] | Supported language codes. |
secili_dil | string | Language picked for this request (Accept-Language). |
telegram_kanal | string | Telegram channel link. |
telegram_bot | string | Telegram bot link. |
{
"domain": "igsub.me",
"ad": "iGSub",
"varsayilan_dil": "en",
"diller": ["en", "tr", "es", "pt", "ar", "fr", "de", "ru"],
"secili_dil": "en",
"telegram_kanal": "https://t.me/...",
"telegram_bot": "https://t.me/..."
}ℹ️ Other fields (analytics ids, verification tags) belong to igsub.me itself — ignore them.
Service catalog
Every service with its limits and credit price. Use it to build the service picker, quantity limits and the cost preview. Hide services where aktif is false.
| Name | Type | Description |
|---|---|---|
servisler[] | Service[] | See the Service model. |
{
"servisler": [
{ "tip": "sub", "platform": "youtube", "tur": "sub", "min_adet": 10, "max_adet": 1000000, "kredi_carpani": 1, "min_referans": 0, "aktif": true, "sira": 0 },
{ "tip": "like", "platform": "youtube", "tur": "like", "min_adet": 10, "max_adet": 1000000, "kredi_carpani": 50, "min_referans": 3, "aktif": true, "sira": 6 },
{ "tip": "comment", "platform": "youtube", "tur": "comment", "min_adet": 1, "max_adet": 1000000, "kredi_carpani": 10, "min_referans": 100, "aktif": true, "sira": 7 },
{ "tip": "comment_like", "platform": "youtube", "tur": "comment_like", "min_adet": 10, "max_adet": 1000000, "kredi_carpani": 15, "min_referans": 5, "aktif": true, "sira": 8 },
{ "tip": "ig_views", "platform": "instagram", "tur": "views", "min_adet": 100, "max_adet": 2147483647, "kredi_carpani": 3, "min_referans": 0, "aktif": false, "sira": 1 }
]
}ℹ️ cost in credits = quantity × kredi_carpani.
ℹ️ min_referans > 0 means the user needs that many invited friends before using the service (error referans_gerekli).
Authentication
Google sign-in with the YouTube TV device code flow. Produces the session token used everywhere else.
Start Google sign-in
Creates a one-time code. Show user_code to the user and send them to qr_url (opens youtube.com/qr/activate with the code pre-filled) or show qr_image to scan with a phone. Keep device_token in memory for polling.
Limit: 12 starts per IP per 10 minutes
| Name | Type | Description |
|---|---|---|
ref | string | Invite code. Use YOUR code to earn +1000 credits for every new user who signs in on your site (or the visitor's ?ref= link if present). Applied when the sign-in completes; max 30 per code per day. Example: AB12CD34 |
| Name | Type | Description |
|---|---|---|
X-FS-Moderequired | string | Must be "token" so device_token / session_token are returned in JSON (no cookies). Example: token |
POST https://igsub.me/api/auth/device/start
{}| Name | Type | Description |
|---|---|---|
user_code | string | Code the user enters (format XXX-XXX-XXX). |
qr_url | string | https://youtube.com/qr/activate/<code> — open in a new tab. |
qr_image | string | PNG QR image URL of qr_url. |
verification_url | string | Plain activation page (code typed manually). |
interval | integer | Seconds to wait between polls (use at least 3). |
expires_in | integer | Seconds until the code expires. |
device_token | string | Opaque flow token; send it as X-FS-Device when polling. |
{
"ok": true,
"user_code": "ABC-DEF-GHI",
"qr_url": "https://youtube.com/qr/activate/ABC-DEF-GHI",
"qr_image": "https://api.qrserver.com/v1/create-qr-code/?size=280x280&data=...",
"verification_url": "https://www.google.com/device",
"interval": 5,
"expires_in": 1800,
"device_token": "eyJ...signed"
}Errors: rate_limitdevice_hata
Poll sign-in
Call every `interval` seconds until status is true, then save session_token (localStorage) and send it as Authorization: Bearer on every call. Always answers HTTP 200; read status/message.
| Name | Type | Description |
|---|---|---|
X-FS-Moderequired | string | "token" Example: token |
X-FS-Devicerequired | string | device_token from /api/auth/device/start. |
| Name | Type | Description |
|---|---|---|
status | boolean | true = signed in. |
session_token | string | Present when status is true. Valid for 30 days. |
message | string | When status is false: "not approved yet" (keep polling), "expired" / "no_flow" (start again), "only gmail" (only @gmail.com accounts), other values = temporary, keep polling. |
{ "status": false, "message": "not approved yet" }
{ "status": true, "redirect_url": "/account", "session_token": "eyJ1aWQiOjEy...signed" }ℹ️ New accounts receive a welcome credit bonus.
ℹ️ A user who already has an account gets the same account and credits (accounts are shared with igsub.me and the blog).
Current user
Validate the stored token on page load. 401 oturum_yok / kullanici_yok = token expired or deleted: clear it and show the sign-in button.
| Name | Type | Description |
|---|---|---|
kullanici.id | integer | User id. |
kullanici.email | string | Gmail address (show only to the user themself). |
kullanici.ad | string | Display name. |
kullanici.avatar | string | Avatar URL. |
kullanici.son_giris | string (date-time) | Last sign-in. |
{
"ok": true,
"kullanici": { "id": 156, "email": "[email protected]", "ad": "Name", "avatar": "https://lh3.googleusercontent.com/...", "son_giris": "2026-10-25T07:55:40Z" }
}Errors: oturum_yokkullanici_yok
Sign out
Tokens are stateless: signing out = deleting session_token from your storage. Calling this endpoint is optional.
POST https://igsub.me/api/auth/logout
{}| Name | Type | Description |
|---|---|---|
ok | boolean | Always true. |
{ "ok": true }Account & credits
The signed-in user, credit balance, credit history, invites and extra-channel credits.
Credit balance
Spendable credits and invite info. Show kredi in the header and refresh it after every order.
| Name | Type | Description |
|---|---|---|
kredi.kredi | integer | Spendable credits (1 credit = 1 unit × kredi_carpani). |
kredi.referans_kod | string | User's own invite code. Invite link: https://igsub.me/?ref=<code> |
kredi.davet_sayisi | integer | Friends invited so far (unlocks min_referans services). |
kredi.kanal_sayisi | integer | Extra YouTube channels found on the account (each adds hourly credits). |
kredi.gunluk_hak | integer | Free credits added every hour. |
kredi.sonraki_sifirlama | string (date-time) | When the next free credits arrive (UTC). |
{
"ok": true,
"kredi": { "kredi": 1000, "bonus_kredi": 0, "referans_kod": "8E6WNYMQ", "davet_sayisi": 0, "kanal_sayisi": 0, "gunluk_hak": 1000, "sonraki_sifirlama": "2026-10-25T08:00:00Z" }
}Errors: oturum_yok
Credit history
Credit movements, newest first.
| Name | Type | Description |
|---|---|---|
limit | integer | Default 50. Example: 30 |
offset | integer | Pagination offset. Example: 0 |
| Name | Type | Description |
|---|---|---|
hareketler[] | CreditTx[] | See the CreditTx model. |
{
"ok": true,
"hareketler": [
{ "id": 991, "tur": "siparis", "miktar": -100, "aciklama": "tip=sub adet=100x1", "order_id": 3927, "olusturma": "2026-10-24T18:05:43Z" },
{ "id": 990, "tur": "saatlik", "miktar": 1000, "aciklama": "hourly", "olusturma": "2026-10-24T18:00:00Z" }
]
}Errors: oturum_yok
Apply an invite code
Manually apply a friend's invite code (the inviter gets +1000 credits). Usually not needed: pass ?ref= to device/start instead.
| Name | Type | Description |
|---|---|---|
X-FS-Captcharequired | string | hCaptcha token from the igsub.me captcha frame (one token per call). |
| Name | Type | Description |
|---|---|---|
kodrequired | string | Invite code. Example: AB12CD34 |
POST https://igsub.me/api/referans/uygula
{ "kod": "AB12CD34" }| Name | Type | Description |
|---|---|---|
ok | boolean | true on success. |
bonus | integer | Credits given to the inviter. |
{ "ok": true, "veren_id": 12, "bonus": 1000 }Errors: captcha_yokcaptcha_retkod_yokreferans_gecersizreferans_kendireferans_varreferans_limit
Claim extra-channel credits
Counts the extra YouTube channels on the user's Google account; every channel adds +1000 credits per hour. Once per hour (when called earlier you get beklemede=true and kalan_saniye).
| Name | Type | Description |
|---|---|---|
X-FS-Captcharequired | string | hCaptcha token from the igsub.me captcha frame (one token per call). |
POST https://igsub.me/api/kredi/kanal-topla
{}| Name | Type | Description |
|---|---|---|
kanal_sayisi | integer | Extra channels found. |
saatlik_kazanc | integer | Credits per hour from channels. |
kredi | integer | New balance. |
beklemede | boolean | true = called too early. |
kalan_saniye | integer | Seconds until it can be called again. |
{ "ok": true, "kanal_sayisi": 3, "saatlik_kazanc": 3000, "kredi": 4000 }
{ "ok": true, "kanal_sayisi": 3, "saatlik_kazanc": 3000, "beklemede": true, "kalan_saniye": 2710 }YouTube lookup
Find channels and videos from any link, @handle or name. Needed to get the channel_id / video_id that orders use.
Find a channel or video
Accepts anything a user may paste: channel URL, @handle, /c/ or /user/ URL, channel name, video URL (watch, youtu.be, shorts) or a bare video id. Returns a channel (tip = "kanal") with its latest videos and similar channels, or a video (tip = "video").
Limit: 40 per minute per IP
| Name | Type | Description |
|---|---|---|
qrequired | string | User input. Example: https://www.youtube.com/@MrBeast |
POST https://igsub.me/api/resolve
{ "q": "https://www.youtube.com/@MrBeast" }| Name | Type | Description |
|---|---|---|
tip | "kanal" | "video" | What was found. |
channel_id | string | UC… id — use as hedef_kanal in orders. |
ad | string | Channel name. |
handle | string | Handle without @ (channel only, may be empty). |
avatar | string | Channel avatar (channel only). |
abone_sayi | integer | Subscriber count (channel only). |
video_sayi | integer | Video count (channel only). |
aciklama | string | Channel description (channel only). |
videolar[] | {id, baslik, kapak, bilgi}[] | Latest videos (channel only). id = video id. |
alternatifler[] | {channel_id, ad, avatar, abone_sayi}[] | Similar channels when the input was a name/handle — show "Not this channel?". |
video_id | string | Video id (video only). |
video | object | Video only: {id, baslik, aciklama, kapak, goruntulenme, sure_sn, yazar}. |
{
"tip": "kanal",
"channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"ad": "MrBeast",
"handle": "mrbeast",
"avatar": "https://yt3.ggpht.com/...",
"abone_sayi": 523000000,
"video_sayi": 900,
"aciklama": "...",
"yontem": "handle",
"videolar": [ { "id": "dQw4w9WgXcQ", "baslik": "Video title", "kapak": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg", "bilgi": "12M views" } ],
"alternatifler": [ { "channel_id": "UC...", "ad": "MrBeast Gaming", "avatar": "...", "abone_sayi": 45000000 } ]
}
{
"tip": "video",
"video_id": "dQw4w9WgXcQ",
"channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw",
"ad": "Channel name",
"video": { "id": "dQw4w9WgXcQ", "baslik": "Title", "aciklama": "...", "kapak": "...", "goruntulenme": 1500000000, "sure_sn": 213, "yazar": "Channel name" }
}Search channels
Channel search by name (max 12). Use for an autocomplete or a "pick your channel" list.
| Name | Type | Description |
|---|---|---|
qrequired | string | Search text. Example: cooking |
| Name | Type | Description |
|---|---|---|
kanallar[] | {channel_id, ad, avatar, abone_sayi}[] | Matching channels. |
{ "kanallar": [ { "channel_id": "UC...", "ad": "Cooking Channel", "avatar": "https://...", "abone_sayi": 120000 } ] }Errors: bos_girdigiris_gerekli
Channel page data
Full channel card plus the first 30 videos. Use it for a channel page (e.g. #/channel/UC...).
| Name | Type | Description |
|---|---|---|
channelIdrequired | string | UC… channel id. Example: UCX6OQ3DkcsbYNE6H8uQQuVA |
| Name | Type | Description |
|---|---|---|
kanal | Channel | See the Channel model. |
videolar[] | Video[] | See the Video model. |
{
"kanal": { "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA", "handle": "mrbeast", "ad": "MrBeast", "aciklama": "...", "avatar": "...", "banner": "", "abone_sayi": 523000000, "video_sayi": 900, "ulke": "", "kategori": "" },
"videolar": [ { "video_id": "...", "channel_id": "UC...", "baslik": "...", "kapak": "...", "goruntulenme": 1000000, "sure_sn": 900, "sira": 1 } ]
}More channel videos / shorts
Paginated videos. Default tab uses limit/offset. For Shorts or live streams pass sekme=shorts|streams and page with the returned devam token (continuation).
| Name | Type | Description |
|---|---|---|
channelIdrequired | string | UC… channel id. |
| Name | Type | Description |
|---|---|---|
limit | integer | 1–100, default 30 (videos tab). Example: 30 |
offset | integer | Offset (videos tab). Example: 30 |
sekme | "videos" | "shorts" | "streams" | Tab. Default videos. Example: shorts |
continuation | string | Next-page token (devam) for shorts/streams. |
| Name | Type | Description |
|---|---|---|
videolar[] | Video[] | Videos (shorts/streams return {video_id, channel_id, baslik, kapak}). |
devam | string | Next page token for shorts/streams ("" = end). |
{ "channel_id": "UC...", "limit": 30, "offset": 30, "videolar": [ ... ] }
{ "channel_id": "UC...", "sekme": "shorts", "videolar": [ { "video_id": "...", "baslik": "...", "kapak": "..." } ], "devam": "4qmFsgK..." }Video page data
Video details plus its channel card. Use it for a video page with like/comment ordering.
| Name | Type | Description |
|---|---|---|
videoIdrequired | string | 11-character video id. Example: dQw4w9WgXcQ |
| Name | Type | Description |
|---|---|---|
video | object | {video_id, baslik, aciklama, channel_id, kapak, goruntulenme, sure_sn, etiketler[], yazar} |
kanal | Channel | {channel_id, ad} | Channel of the video. |
{
"video": { "video_id": "dQw4w9WgXcQ", "baslik": "Title", "aciklama": "...", "channel_id": "UC...", "kapak": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg", "goruntulenme": 1500000000, "sure_sn": 213, "etiketler": ["music"], "yazar": "Channel" },
"kanal": { "channel_id": "UC...", "ad": "Channel", "avatar": "...", "abone_sayi": 4000000 }
}Orders
Create orders, follow live progress and list the user's history.
Create an order
Without sign-in: 100 free YouTube subscribers (tip sub only) once per channel, max 1 free order per hour per visitor, hCaptcha required. Signed in: spends credits (quantity × kredi_carpani) and starts delivery immediately. YouTube services need hedef_kanal (channel_id from /api/resolve); like and comment also need hedef_video. Instagram / TikTok / X / Facebook services need the full post URL in hedef_video and no hedef_kanal.
Limit: 30 orders per hour per user (external sites) · 20 per hour per IP
| Name | Type | Description |
|---|---|---|
tiprequired | string | Service type from /api/link-servisler: sub, like, comment, comment_like (YouTube) · ig_views, ig_likes, tiktok_views, x_views, fb_likes (only when aktif). Example: sub |
hedef_kanal | string | YouTube channel_id (UC…). Required for YouTube services. Example: UCX6OQ3DkcsbYNE6H8uQQuVA |
hedef_video | string | YouTube video id (like, comment, comment_like) or full post URL (Instagram/TikTok/X/Facebook). Example: dQw4w9WgXcQ |
adet | integer | Quantity. Signed in: clamped to the service min/max and to what the balance can pay (omit = 100). Without sign-in: always 100 (omit it). Example: 100 |
captcha_tokenrequired | string | hCaptcha token, required for every order. Get it from the igsub.me captcha frame (see "hCaptcha" section): open https://igsub.me/captcha/frame.html in an iframe and read the token from the postMessage { fsCaptcha }. Single use. |
fingerprint | string | Stable device id (random string kept in localStorage). Recommended without sign-in: the free quota is counted per IP + fingerprint. |
POST https://igsub.me/api/order
{ "tip": "sub", "hedef_kanal": "UCX6OQ3DkcsbYNE6H8uQQuVA", "adet": 100, "captcha_token": "P1_eyJ0eXAi..." }
{ "tip": "like", "hedef_kanal": "UCX6OQ3DkcsbYNE6H8uQQuVA", "hedef_video": "dQw4w9WgXcQ", "adet": 50, "captcha_token": "P1_eyJ0eXAi..." }
{ "tip": "tiktok_views", "hedef_video": "https://www.tiktok.com/@user/video/7300000000000000000", "adet": 1000, "captcha_token": "P1_eyJ0eXAi..." }| Name | Type | Description |
|---|---|---|
order_id | string | Unguessable order token. Keep it: it is the key for tracking (share links like #/order/<order_id>). |
status | OrderStatus | Usually "queued"; "failed" if dispatch failed (credits refunded automatically). |
durum | string | Same status, internal name. |
adet | integer | Final quantity after clamping. |
{ "ok": true, "order_id": "c43a7ec92aef79f3e7f96c1b55125d44", "durum": "kuyrukta", "status": "queued", "adet": 100 }Errors: giris_gereklikanal_cooldowncaptcha_yokcaptcha_retgecersiz_tiphedef_yoklink_gecersizservis_yokkredi_yokmin_kredireferans_gereklirate_limitgecersiz_govde
ℹ️ Every order needs a fresh hCaptcha token (one token = one order).
ℹ️ Request body must contain only these fields (unknown fields → 400 gecersiz_govde).
ℹ️ Refresh /api/kredi after an order.
Order progress
Live progress, synced with the delivery engine on every call. Poll every 8–15 seconds while the status is not final. Progress = biten_sayac / adet.
| Name | Type | Description |
|---|---|---|
order_idrequired | string | Token from /api/order. |
| Name | Type | Description |
|---|---|---|
order_id | string | Order token. |
tip | string | Service type. |
status | OrderStatus | pending | queued | in_progress | completed | partial | canceled | failed. |
adet | integer | Ordered quantity. |
baslangic_sayac | integer | Counter (subscribers/likes) when delivery started; 0 until known. |
biten_sayac | integer | Units delivered so far. |
hedef_kanal | string | Target channel. |
hedef_video | string | Target video / link. |
olusturma | string (date-time) | Created at. |
biten | string (date-time) | null | Finished at. |
{
"order_id": "c43a7ec92aef79f3e7f96c1b55125d44",
"tip": "sub",
"durum": "calisiyor",
"status": "in_progress",
"adet": 100,
"baslangic_sayac": 18300,
"biten_sayac": 40,
"hedef_kanal": "UCKtuGDfMjgNe5M9Eu_XsdRw",
"hedef_video": "",
"olusturma": "2026-10-24T18:05:43Z",
"biten": null
}Errors: siparis_yokgiris_gerekli
Order timeline
Step-by-step events for a timeline view.
| Name | Type | Description |
|---|---|---|
order_idrequired | string | Order token. |
| Name | Type | Description |
|---|---|---|
olaylar[] | OrderEvent[] | See the OrderEvent model. |
{
"order_id": "c43a7ec9...",
"olaylar": [
{ "id": 1, "olay": "olusturuldu", "detay": "tip=sub adet=100", "ts": "2026-10-24T18:05:43Z" },
{ "id": 2, "olay": "kuyruga_alindi", "detay": "ref=...", "ts": "2026-10-24T18:05:44Z" }
]
}Errors: siparis_yok
My orders
The signed-in user's orders on every site, newest first, with the latest event.
| Name | Type | Description |
|---|---|---|
limit | integer | Default 50. Example: 20 |
offset | integer | Pagination offset. Example: 0 |
| Name | Type | Description |
|---|---|---|
siparisler[] | OrderSummary[] | See the OrderSummary model. Link each row with public_token. |
{
"ok": true,
"siparisler": [
{ "id": 3927, "public_token": "c43a7ec9...", "platform": "youtube", "tip": "sub", "hedef_kanal": "UC...", "hedef_video": "", "adet": 1000, "durum": "tamamlandi", "status": "completed", "baslangic_sayac": 18300, "biten_sayac": 1000, "son_olay": "kuyruga_alindi", "olusturma": "2026-10-24T18:05:43Z", "biten": "2026-10-24T18:41:02Z" }
]
}Errors: oturum_yok
One of my orders
Summary plus full event list of one order owned by the user (numeric id from /api/siparislerim).
| Name | Type | Description |
|---|---|---|
idrequired | integer | Numeric order id. |
| Name | Type | Description |
|---|---|---|
siparis | OrderSummary | Order summary. |
olaylar[] | OrderEvent[] | Events. |
{ "ok": true, "siparis": { ... }, "olaylar": [ ... ] }Errors: gecersiz_idsiparis_yokoturum_yok
Social proof
Recent completed deliveries (masked names) for a live activity feed.
Recent deliveries
Orders completed in the last 24 hours across all sites (newest first, up to 100) for a "just delivered" ticker. Names are masked server-side; no e-mail, channel or IP is returned. Cached 30 seconds.
| Name | Type | Description |
|---|---|---|
siparisler[] | {tip, adet, ad, saniye_once}[] | ad = masked name ("" = guest), saniye_once = seconds ago. |
{ "siparisler": [ { "tip": "sub", "adet": 100, "ad": "Al***", "saniye_once": 42 }, { "tip": "like", "adet": 50, "ad": "", "saniye_once": 95 } ] }Games & jackpots
Play with free credits: 80+ games (single-request games, tumble slots, step-by-step card/mines/chain games), four jackpot tiers with a progressive pool and a live feed. Every result is decided on the server with a crypto RNG and every game returns at most 97%. Credits are free and can never be bought or cashed out. Bets 10–2000. Rules, payout tables and the live feed are public; playing needs sign-in.
Game rules & payout tables
Bet limits, the return-to-player cap and every payout table, so your page can show odds and pay tables next to each game. Static data — fetch it once per page session. Probabilities (olasilik) are percentages; multipliers (carpan) are the TOTAL return per 1 credit bet (2 = you get double your bet back).
| Name | Type | Description |
|---|---|---|
min_bahis | integer | Minimum bet (10). |
max_bahis | integer | Maximum bet (2000). |
max_adet | integer | Max hands in one request (10, plinko balls only). |
rtp | number | Return-to-player cap of every game (0.97). |
coin_carpan | number | Coin flip payout (1.94). |
slot[] | {ad, olasilik, carpan}[] | Classic slot table (theme "classic"): symbol row, chance in %, multiplier. |
slot_tema | object | Other slot themes: theme → [{ad, olasilik, carpan}] (candy, space, gems, egypt). Visual themes lucky7/fruitstand/neon/ocean/samurai/western/royal reuse classic/candy/space/gems/egypt/space/gems. |
plinko | object | Key "<rows><risk>" (8low … 16high) → multiplier per pocket (rows + 1 pockets, left to right). |
wheel | object | low (10 slices) / medium (20) / high (30) → multiplier per slice, all slices equally likely. |
tumble | object | {oyunlar: theme → profile, profiller: profile → {mod, sutun, satir, odeme, scatter_odeme, bonus_fiyat, kure, nokta_tavan}, max_carpan, fs, fs_ek, bonus_max}. See "Tumble slots" in the game catalog. |
jackpot_kademe[] | {ad, carpan, bolen}[] | Jackpot tiers: name, fixed multiplier of the bet, chance 1/bolen per hand. |
zincir | object | Chain games: key → {mod ("kule" pick a box per row | "tek" just advance), risk: level → [n, k] (k of n safe), max_adim}. |
keno | number[][] | keno[picks][hits] → multiplier (picks 1–10; index 0 is null). |
sicbo | object | Bet → multiplier (small, big, odd, even, triple_any, triple:1–6, double:1–6, total:4–17). |
at | number[] | Horse race multiplier for horse 1–6. |
at_olas | integer[] | Win chance of horse 1–6 in %. |
dart | object | Darts risk (low, medium, high) → [{ad, olasilik, carpan}]. |
money_dilim | integer[] | Money wheel: value of each of the 54 slices in wheel order. |
money_carpan | object | Money wheel: slice value ("1", "2", "5", "10", "20", "40") → multiplier. |
{
"ok": true,
"min_bahis": 10,
"max_bahis": 2000,
"max_adet": 10,
"rtp": 0.97,
"coin_carpan": 1.94,
"slot": [ { "ad": "diamond", "olasilik": 0.2, "carpan": 50 }, { "ad": "seven", "olasilik": 0.6, "carpan": 20 }, { "ad": "cherry", "olasilik": 2, "carpan": 10 }, { "ad": "lemon", "olasilik": 4, "carpan": 5 }, { "ad": "pair", "olasilik": 17.5, "carpan": 2 } ],
"slot_tema": { "candy": [ { "ad": "big", "olasilik": 1, "carpan": 10 }, { "ad": "mid", "olasilik": 4, "carpan": 5 }, { "ad": "small", "olasilik": 10, "carpan": 2.5 }, { "ad": "pair", "olasilik": 28, "carpan": 1.5 } ] },
"plinko": { "8low": [5.48, 2.05, 1.07, 0.97, 0.48, 0.97, 1.07, 2.05, 5.48] },
"wheel": { "low": [1.42, 1.14, 1.14, 1.14, 0, 1.14, 1.14, 1.14, 1.42, 0] },
"tumble": {
"oyunlar": { "thunder": "sc-high", "sugar": "cl-mid" },
"profiller": { "sc-high": { "mod": "scatter", "sutun": 6, "satir": 5, "odeme": [[0.35, 1.05, 2.81]], "scatter_odeme": [4.22, 7.03, 140.7], "bonus_fiyat": 80, "kure": [2, 3, 5, 8, 10, 15, 20, 25, 50, 100], "nokta_tavan": 0 } },
"max_carpan": 5000, "fs": 10, "fs_ek": 5, "bonus_max": 50000
},
"jackpot_kademe": [ { "ad": "grand", "carpan": 500, "bolen": 200000 }, { "ad": "major", "carpan": 150, "bolen": 30000 }, { "ad": "minor", "carpan": 50, "bolen": 12500 }, { "ad": "mini", "carpan": 10, "bolen": 4000 } ],
"zincir": { "towers": { "mod": "kule", "risk": { "easy": [4, 3], "medium": [3, 2], "hard": [2, 1], "expert": [3, 1] }, "max_adim": 9 } },
"keno": [null, [0, 3.88], [0, 1.72, 5.28]],
"sicbo": { "small": 1.99, "big": 1.99, "triple_any": 34.92, "total:4": 69.84 },
"at": [3.23, 4.04, 5.38, 7.46, 10.77, 16.16],
"at_olas": [30, 24, 18, 13, 9, 6],
"dart": { "low": [ { "ad": "bull", "olasilik": 2, "carpan": 4.94 }, { "ad": "inner", "olasilik": 18, "carpan": 1.48 }, { "ad": "outer", "olasilik": 50, "carpan": 1.08 }, { "ad": "miss", "olasilik": 30, "carpan": 0.19 } ] },
"money_dilim": [1, 2, 1, 5, 1, 2, 1, 10],
"money_carpan": { "1": 2.18, "2": 3.49, "5": 7.48, "10": 13.09, "20": 26.19, "40": 26.19 }
}Errors: rate_limitdb_hata
ℹ️ The example is shortened: the real response has every plinko/wheel/slot/tumble/zincir/keno/sicbo/dart entry and all 54 money_dilim values.
ℹ️ Public on external sites (no sign-in needed).
Play one hand (single-request games)
Places the bet and returns the result in one call: the bet is taken, the result is drawn on the server, the payout is added and a jackpot roll is made — all in one transaction. Which of secim / hedef / x / satir / risk / adet / bonus you send depends on the game (see the game catalog). Animate the result on your side; the outcome is already final.
Limit: 60 hands per minute per user · 90 requests per minute per user (external sites)
| Name | Type | Description |
|---|---|---|
oyunrequired | string | Game key: coin, dice, limbo, crash, slots, scratch, plinko, wheel, roulette, rps, lucky, cups, baccarat, keno, sicbo, dragontiger, ou7, horse, darts, moneywheel, tumble. Example: coin |
bahisrequired | integer | Bet per hand, 10–2000 credits (400 bahis otherwise). For plinko with adet > 1 the cost is bahis × adet; for a tumble bonus buy it is bahis × bonus_fiyat. Example: 100 |
secim | string | coin: heads | tails · roulette: red | black | even | odd | low | high | dozen1–dozen3 | col1–col3 | n:0 … n:36 · rps: rock | paper | scissors · baccarat: player | banker | tie · dragontiger: dragon | tiger | tie · ou7: under | over | seven · sicbo: small | big | odd | even | triple_any | triple:1–6 | double:1–6 | total:4–17 · keno: 1–10 different numbers 1–40, comma separated ("3,7,12") · moneywheel: "1" | "2" | "5" | "10" | "20" | "40" · slots: theme classic (default) | candy | space | gems | egypt | lucky7 | fruitstand | neon | ocean | samurai | western | royal · tumble: theme key (required, 30 themes, see catalog). Example: heads |
hedef | integer | dice: 2–95 (win when the roll is below it) · lucky: 1–10 · cups: 1–3 · horse: 1–6. Example: 50 |
x | number | limbo / crash: target multiplier 1.01–1000 (2 decimals, rounded down). Example: 2.5 |
satir | integer | plinko: rows 8 | 12 | 16. Example: 12 |
risk | string | plinko, wheel, darts: low | medium | high. Example: medium |
adet | integer | plinko only: balls in one request, 1–10 (default 1). Other games must send 1 or omit it. Example: 1 |
bonus | boolean | tumble only: buy 10 free spins directly for bahis × bonus_fiyat credits (max 50000). Example: false |
POST https://igsub.me/api/oyun/oyna
{ "oyun": "coin", "bahis": 100, "secim": "heads" }
{ "oyun": "dice", "bahis": 50, "hedef": 50 }
{ "oyun": "limbo", "bahis": 100, "x": 2.5 }
{ "oyun": "plinko", "bahis": 20, "satir": 12, "risk": "medium", "adet": 5 }
{ "oyun": "roulette", "bahis": 100, "secim": "n:17" }
{ "oyun": "keno", "bahis": 100, "secim": "3,7,12,25,33" }
{ "oyun": "slots", "bahis": 100, "secim": "egypt" }
{ "oyun": "tumble", "bahis": 20, "secim": "thunder", "bonus": true }| Name | Type | Description |
|---|---|---|
sonuc | GameResult | The (first) hand. See the GameResult model. |
sonuclar[] | GameResult[] | Every hand (several only for plinko with adet > 1). sonuc.jackpot is set on the first hand when a jackpot hit. |
kredi | integer | Only on 402 yetersiz_kredi: the current balance. |
{
"ok": true,
"sonuc": { "oyun": "coin", "bahis": 100, "kazanc": 194, "net": 94, "carpan": 1.94, "sonuc": "heads", "indeks": 0, "kredi": 5194 },
"sonuclar": [ { "oyun": "coin", "bahis": 100, "kazanc": 194, "net": 94, "carpan": 1.94, "sonuc": "heads", "indeks": 0, "kredi": 5194 } ]
}
{
"ok": true,
"sonuc": { "oyun": "dice", "bahis": 50, "kazanc": 0, "net": -50, "carpan": 0, "sonuc": "", "deger": 73.12, "indeks": 0, "kredi": 5144 },
"sonuclar": [ { "oyun": "dice", "bahis": 50, "kazanc": 0, "net": -50, "carpan": 0, "sonuc": "", "deger": 73.12, "indeks": 0, "kredi": 5144 } ]
}
{
"ok": true,
"sonuc": { "oyun": "limbo", "bahis": 100, "kazanc": 250, "net": 150, "carpan": 2.5, "sonuc": "", "deger": 3.87, "indeks": 0, "kredi": 5294, "jackpot": { "ad": "mini", "tutar": 1000 } },
"sonuclar": [ ... ]
}
{ "ok": false, "hata": "yetersiz_kredi", "kredi": 40, "error": "yetersiz_kredi" }Errors: oturum_yokgiris_gerekliyetersiz_kredibahisgecersizrate_limitdb_hata
ℹ️ kazanc = floor(bahis × carpan) (fractions are rounded down); net = kazanc − bahis; kredi = new balance after the hand and any jackpot. Show kredi in your header.
ℹ️ yetersiz_kredi is answered as { "ok": false, "hata": "yetersiz_kredi", "kredi": <balance> } (402) — the code is in hata, not kod. Read kod || hata.
ℹ️ One jackpot roll per request (also for 10 plinko balls). A hit adds jackpot.tutar to the balance and appears in the live feed.
ℹ️ Payout cap: 200000 credits in one hand.
Step-by-step games (start, move, cash out)
Blackjack, mines, hi-lo, video poker and the 14 chain games (oyun "zn-<key>") are played in steps. hamle "basla" takes the bet and opens a session (one active session per user per game, kept on the server for 24 hours); the following moves change it until the game ends (durum.bitti = true), when the payout is added. Hidden information (dealer hole card, mine positions, the deck) stays on the server and is revealed only when the game ends.
Limit: 150 moves per minute per user · 90 requests per minute per user (external sites)
| Name | Type | Description |
|---|---|---|
oyunrequired | string | blackjack | mines | hilo | videopoker | zn-<key> (zn-towers, zn-dragontower, zn-doors, zn-defuse, zn-ladder, zn-bridge, zn-icelake, zn-minecart, zn-pump, zn-chicken, zn-streak, zn-penalty, zn-spacejump, zn-heist). Example: mines |
hamlerequired | string | basla (start, every game) · blackjack: hit | stand | double · mines: ac | nakit · hilo: yuksek | dusuk | atla | nakit · videopoker: cek · zn-*: ac | nakit. ac = reveal/advance, nakit = cash out, yuksek/dusuk = higher/lower, atla = skip card, cek = draw. Example: basla |
bahis | integer | basla only: bet 10–2000. Blackjack "double" takes the same bet again. Example: 100 |
mayin | integer | mines + basla: number of mines 1–24 on the 5×5 board. Example: 3 |
hucre | integer | mines + ac: cell 0–24 (row × 5 + column, not opened before) · zn-* "kule" games + ac: box 0 … n−1 in the next row. Ignored by "tek" chain games. Example: 12 |
tut | boolean[5] | videopoker + cek: which of the 5 cards to hold (true = keep). Exactly 5 values. Example: [true, true, false, false, true] |
risk | string | zn-* + basla: difficulty, one of the game's risk levels (see GET /api/oyun zincir and the game catalog). Example: medium |
POST https://igsub.me/api/oyun/hamle
{ "oyun": "mines", "hamle": "basla", "bahis": 100, "mayin": 3 }
{ "oyun": "mines", "hamle": "ac", "hucre": 12 }
{ "oyun": "mines", "hamle": "nakit" }
{ "oyun": "blackjack", "hamle": "basla", "bahis": 100 }
{ "oyun": "blackjack", "hamle": "stand" }
{ "oyun": "videopoker", "hamle": "cek", "tut": [true, true, false, false, true] }
{ "oyun": "zn-towers", "hamle": "basla", "bahis": 50, "risk": "medium" }| Name | Type | Description |
|---|---|---|
durum | GameSession | Visible state after the move. See the GameSession model. |
kredi | integer | Only on 402 yetersiz_kredi: the current balance. |
{
"ok": true,
"durum": { "oyun": "mines", "bitti": false, "bahis": 100, "toplam": 100, "kazanc": 0, "carpan": 1.1, "mayin": 3, "acik": [12], "sonraki": 1.25, "kredi": 4900 }
}
{
"ok": true,
"durum": { "oyun": "mines", "bitti": true, "bahis": 100, "toplam": 100, "kazanc": 125, "carpan": 1.25, "sonuc": "cashout", "mayin": 3, "acik": [12, 7], "mayinlar": [3, 18, 22], "kredi": 5025 }
}
{
"ok": true,
"durum": { "oyun": "blackjack", "bitti": false, "bahis": 100, "toplam": 100, "kazanc": 0, "carpan": 0, "oyuncu": [9, 23], "kurp": [44, -1], "oyuncu_t": 20, "kurp_t": 6, "kredi": 4900, "ikikat_ok": true }
}Errors: oturum_yokgiris_gerekliyetersiz_kredibahisgecersizoturum_yok_oyunrate_limitdb_hata
ℹ️ basla while a session of the same game is still open does not take a new bet: it returns the open session (safe on double clicks and page reloads).
ℹ️ Any move other than basla without an open session → 409 oturum_yok_oyun. Call GET /api/oyun/oturum on page load to resume.
ℹ️ Invalid moves (opening the same cell twice, double after the first two cards, cash out before the first safe step, wrong tut length) → 400 gecersiz.
ℹ️ The jackpot roll happens once at basla (durum.jackpot). When bitti is true: kazanc = payout, carpan = kazanc / toplam, sonuc = result.
ℹ️ Sessions untouched for 24 hours are closed and their bet is lost.
Resume an open game
The open session of a step-by-step game for the signed-in user, or null. Call it when the game page opens so a refreshed page continues the same hand.
| Name | Type | Description |
|---|---|---|
oyunrequired | string | blackjack | mines | hilo | videopoker | zn-<key>. Example: blackjack |
| Name | Type | Description |
|---|---|---|
durum | GameSession | null | Open session (bitti is always false here) or null. |
{
"ok": true,
"durum": { "oyun": "hilo", "bitti": false, "bahis": 100, "toplam": 100, "kazanc": 0, "carpan": 1.4, "kart": 4, "gecmis": [8, 4], "tahmin": ["dusuk"], "p_yuksek": 0.6923076923076923, "p_dusuk": 0.38461538461538464, "kredi": 0 }
}
{ "ok": true, "durum": null }Errors: oturum_yokgiris_gereklidb_hata
ℹ️ kredi is 0 in this response (not loaded); use GET /api/kredi for the balance.
Live feed, statistics & jackpot pools
Everything for a live game lobby: the latest hands, today's big wins, leaders, 30-day records, the four jackpot pools and recent jackpot winners, plus period statistics per player and per game (with the real return). Names are masked. Signed in, it also returns the user's own statistics. Use ?hafif=1 for a small, fast answer with only the jackpot pools and the last 5 jackpot winners (ideal for a ticker; poll every 5–15 s).
| Name | Type | Description |
|---|---|---|
hafif | string | "1" = light answer: only jackpot and jackpot_son (max 5). Example: 1 |
donem | "24h" | "7d" | "30d" | Period of genel.donem statistics. Default 24h. Example: 7d |
| Name | Type | Description |
|---|---|---|
jackpot[] | JackpotPool[] | hafif=1 only: the four tiers. |
jackpot_son[] | JackpotWin[] | hafif=1 only: last 5 jackpot winners. |
genel | GameFeed | Full answer: public feed and statistics. See the GameFeed model. |
benim | object | Signed in only (last 30 days): {el, harcanan, kazanilan, net, en_iyi_carpan, en_buyuk, bugun_net, favori, oyun_bazli (game → hands), oyunlar[] (per-game summary), gunluk[] ({gun, net, harcama, el} for 14 days), jackpotlar[] (JackpotWin), kazanma (share of winning hands 0–1)}. |
benim_son[] | FeedRow[] | Signed in only: the user's last 25 hands. |
{
"ok": true,
"jackpot": [
{ "ad": "grand", "carpan": 500, "havuz": 18234, "bolen": 200000 },
{ "ad": "major", "carpan": 150, "havuz": 6120, "bolen": 30000 },
{ "ad": "minor", "carpan": 50, "havuz": 2310, "bolen": 12500 },
{ "ad": "mini", "carpan": 10, "havuz": 655, "bolen": 4000 }
],
"jackpot_son": [ { "oyuncu": "Me***", "ad": "mini", "tutar": 1655, "oyun": "plinko", "bahis": 100, "zaman": "2026-10-30T09:12:44Z" } ]
}
{
"ok": true,
"genel": {
"son": [ { "oyuncu": "Al***", "oyun": "tb-thunder", "bahis": 100, "kazanc": 2350, "carpan": 23.5, "zaman": "2026-10-30T09:15:02Z" } ],
"buyuk": [ { "oyuncu": "Ka***", "oyun": "zn-towers", "bahis": 500, "kazanc": 21500, "carpan": 43, "zaman": "2026-10-30T07:41:10Z" } ],
"liderler": [ { "oyuncu": "Ka***", "net": 20400, "el": 312, "harcama": 48000, "kazanc": 0, "en_iyi": 0, "favori": "", "son": "" } ],
"rekor": [ { "oyuncu": "Se***", "oyun": "plinko", "bahis": 2000, "kazanc": 196060, "carpan": 98.03, "zaman": "2026-10-28T21:03:55Z" } ],
"jackpot": [ { "ad": "grand", "carpan": 500, "havuz": 18234, "bolen": 200000 } ],
"jackpot_son": [ { "oyuncu": "Me***", "ad": "mini", "tutar": 1655, "oyun": "plinko", "bahis": 100, "zaman": "2026-10-30T09:12:44Z" } ],
"donem": {
"donem": "24h",
"kazananlar": [ { "oyuncu": "Ka***", "net": 20400, "el": 312, "harcama": 48000, "kazanc": 68400, "en_iyi": 43, "favori": "zn-towers", "son": "2026-10-30T09:01:13Z" } ],
"oynayanlar": [],
"kaybedenler": [],
"oyunlar": [ { "oyun": "plinko", "el": 5120, "oyuncu": 210, "harcama": 402000, "odeme": 388100, "rtp": 0.9654, "en_iyi": 98.03, "en_buyuk": 194060, "kazanma": 0.41 } ],
"toplam": { "el": 40210, "harcama": 3120000, "odeme": 3021000, "oyuncu": 1290 }
},
"gun": { "el": 40210, "harcama": 3120000, "oyuncu": 1290 }
}
}Errors: db_hata
ℹ️ The first example is ?hafif=1, the second the full answer (shortened). The public part is cached for 3 seconds.
ℹ️ Public on external sites (no sign-in needed); send Authorization to also get benim / benim_son.
ℹ️ In liderler only oyuncu, net, el and harcama are filled (the other Lider fields are 0 / "").
Wheel, streak, raffle & tournament
Extra free credits and competitions: hourly lucky wheel, 7-day daily streak, daily raffle and the weekly tournament (highest multiplier wins). The tournament is public; the rest needs sign-in.
Weekly tournament
This week's leaderboard (top 10), the signed-in user's place and last week's winners. A week runs Monday 00:00 – Sunday 23:59 UTC. Each player is ranked by their single best multiplier (carpan) on a hand with a bet of at least 100 credits; on a tie the earlier hand wins. When the week ends the prizes are paid automatically: 25000 / 10000 / 5000 credits for places 1–3 and 1000 for places 4–10.
| Name | Type | Description |
|---|---|---|
turnuva | Tournament | See the Tournament model. |
{
"ok": true,
"turnuva": {
"bas": "2026-10-26T00:00:00Z",
"bitis": "2026-11-02T00:00:00Z",
"min_bahis": 100,
"oduller": [25000, 10000, 5000, 1000, 1000, 1000, 1000, 1000, 1000, 1000],
"liderler": [
{ "sira": 1, "oyuncu": "Se***", "carpan": 980.03, "oyun": "plinko", "bahis": 100, "zaman": "2026-10-28T21:03:55Z", "odul": 25000 },
{ "sira": 2, "oyuncu": "Ka***", "carpan": 312.5, "oyun": "limbo", "bahis": 200, "zaman": "2026-10-29T11:20:07Z", "odul": 10000 }
],
"benim": { "sira": 37, "oyuncu": "Na***", "carpan": 12.4, "oyun": "tb-candy", "bahis": 100, "zaman": "2026-10-30T08:00:12Z", "odul": 0 },
"gecen": [ { "sira": 1, "oyuncu": "Al***", "carpan": 1000, "oyun": "crash", "bahis": 150, "zaman": "2026-10-22T19:45:00Z", "odul": 25000 } ]
}
}Errors: db_hata
ℹ️ Public on external sites (no sign-in needed); benim appears only when signed in and the user has a qualifying hand.
ℹ️ The leaderboard is cached for 10 seconds.
Daily streak status
The 7-day login streak: one bonus per UTC day — 100, 200, 300, 500, 750, 1000 and 2500 credits on day 7 — then it starts again at day 1. Missing a day restarts the streak at day 1.
| Name | Type | Description |
|---|---|---|
seri | Streak | See the Streak model. |
{
"ok": true,
"seri": { "seri": 3, "bugun": false, "sonraki": 4, "oduller": [100, 200, 300, 500, 750, 1000, 2500], "sifirlama": "2026-10-31T00:00:00Z" }
}Errors: oturum_yokgiris_gereklidb_hata
Claim today's streak bonus
Adds today's bonus (oduller[sonraki − 1]) to the balance and moves the streak forward. Once per UTC day.
POST https://igsub.me/api/seri/al
{}| Name | Type | Description |
|---|---|---|
seri | Streak | New state, with kazanilan (credits added) and kredi (new balance). |
{
"ok": true,
"seri": { "seri": 4, "bugun": true, "sonraki": 5, "oduller": [100, 200, 300, 500, 750, 1000, 2500], "sifirlama": "2026-10-31T00:00:00Z", "kredi": 5500, "kazanilan": 500 }
}
{ "ok": false, "hata": "alindi", "error": "alindi" }Errors: oturum_yokgiris_gereklialindidb_hata
ℹ️ Already claimed today → 409 { "ok": false, "hata": "alindi" } (code in hata). Show a countdown to sifirlama.
Hourly lucky wheel status
Whether the user can spin the free wheel this hour, the last prize and the wheel slices (prizes in display order). One spin per user per clock hour (UTC).
| Name | Type | Description |
|---|---|---|
giris | boolean | true when signed in. |
hazir | boolean | true = a spin is available now. |
son_miktar | integer | Prize of this hour's spin (0 if not spun yet). |
sonraki | string (date-time) | Start of the next hour (next spin). |
dilimler | integer[] | Credits on each slice in wheel order: 100, 500, 200, 1000, 300, 2500, 750, 5000. |
{ "ok": true, "giris": true, "hazir": true, "son_miktar": 0, "sonraki": "2026-10-30T10:00:00Z", "dilimler": [100, 500, 200, 1000, 300, 2500, 750, 5000] }Errors: giris_gereklidb_hata
ℹ️ On igsub.me itself it answers without sign-in too (giris false, hazir false); external sites need the session token.
Spin the hourly wheel
Picks the prize on the server and adds it to the balance. Spin your wheel animation so it stops on slice indeks.
POST https://igsub.me/api/cark/cevir
{}| Name | Type | Description |
|---|---|---|
indeks | integer | Winning slice (index into dilimler). |
miktar | integer | Credits won. |
kredi | integer | New balance (also sent with cark_bekle). |
sonraki | string (date-time) | Next spin time. |
{ "ok": true, "indeks": 2, "miktar": 200, "kredi": 5200, "sonraki": "2026-10-30T10:00:00Z" }
{ "ok": false, "hata": "cark_bekle", "sonraki": "2026-10-30T10:00:00Z", "kredi": 5200, "error": "cark_bekle" }Daily raffle status
Today's raffle (UTC day): tickets cost 100 credits, max 50 per user per day. When the day ends one ticket is drawn and its owner wins 97% of all ticket credits.
| Name | Type | Description |
|---|---|---|
cekilis | object | {gun, toplam_bilet, katilimci, havuz (prize now), benim_bilet, bilet_fiyat (100), max_bilet (50), bitis (draw time), son_kazanan (masked), son_odul, son_ben_kazandim}. |
{
"ok": true,
"cekilis": { "gun": "2026-10-30", "toplam_bilet": 420, "katilimci": 61, "havuz": 40740, "benim_bilet": 5, "bilet_fiyat": 100, "max_bilet": 50, "bitis": "2026-10-31T00:00:00Z", "son_kazanan": "Ay***", "son_odul": 38800 }
}Errors: giris_gereklidb_hata
Buy raffle tickets
Buys adet tickets for today's raffle (adet × 100 credits).
| Name | Type | Description |
|---|---|---|
adetrequired | integer | Tickets, 1–50 (today's total per user max 50). Example: 5 |
POST https://igsub.me/api/cekilis/bilet
{ "adet": 5 }| Name | Type | Description |
|---|---|---|
kredi | integer | New balance. |
benim_bilet | integer | User's tickets today. |
{ "ok": true, "kredi": 4500, "benim_bilet": 5 }
{ "ok": false, "hata": "limit", "benim_bilet": 48, "error": "limit" }Errors: oturum_yokgiris_gerekligecersizlimityetersiz_kredidb_hata
Data models
Service
Item of /api/link-servisler.
| Name | Type | Description |
|---|---|---|
tip | string | Service type used in orders. |
platform | string | youtube | instagram | tiktok | x | facebook |
tur | string | sub | like | comment | comment_like | views | likes |
min_adet | integer | Minimum quantity. |
max_adet | integer | Maximum quantity per order. |
kredi_carpani | integer | Credits per unit. |
min_referans | integer | Invites needed to unlock (0 = open). |
aktif | boolean | false = hide it. |
sira | integer | Display order. |
Channel
YouTube channel card.
| Name | Type | Description |
|---|---|---|
channel_id | string | UC… id. |
handle | string | Handle without @. |
ad | string | Name. |
aciklama | string | Description. |
avatar | string | Avatar URL. |
banner | string | Banner URL (may be empty). |
abone_sayi | integer | Subscribers. |
video_sayi | integer | Videos. |
Video
Video card in channel lists.
| Name | Type | Description |
|---|---|---|
video_id | string | Video id. |
channel_id | string | Channel id. |
baslik | string | Title. |
aciklama | string | Description. |
kapak | string | Thumbnail URL (fallback: https://i.ytimg.com/vi/<id>/mqdefault.jpg). |
goruntulenme | integer | Views. |
sure_sn | integer | Duration in seconds. |
etiketler | string[] | Tags. |
OrderSummary
Row of /api/siparislerim.
| Name | Type | Description |
|---|---|---|
id | integer | Numeric id (for /api/siparislerim/{id}). |
public_token | string | Order token (for /api/order/{order_id}). |
platform | string | Platform. |
tip | string | Service type. |
hedef_kanal | string | Target channel. |
hedef_video | string | Target video / link. |
adet | integer | Quantity. |
status | OrderStatus | English status. |
baslangic_sayac | integer | Start count. |
biten_sayac | integer | Delivered. |
son_olay | string | Latest event name. |
olusturma | string (date-time) | Created. |
biten | string (date-time) | Finished (omitted while running). |
OrderEvent
Timeline item.
| Name | Type | Description |
|---|---|---|
olay | string | olusturuldu (created) · kuyruga_alindi (queued for delivery) · teslimat_hata (dispatch error) · kredi_iade (credits refunded) · otomatik_sonlandir (closed automatically) |
detay | string | Free text detail. |
ts | string (date-time) | Time. |
CreditTx
Credit history row.
| Name | Type | Description |
|---|---|---|
tur | string | saatlik (hourly free credits) · hosgeldin (welcome bonus) · referans_bonus (invite bonus) · siparis (order, negative) · iade (refund) · oyun (game: bet/payout, net per hand) · jackpot (jackpot win) · seri (daily streak) · turnuva (tournament prize) · cark (hourly wheel) · cekilis (raffle tickets / win) |
miktar | integer | + added / − spent. |
aciklama | string | Detail. |
order_id | integer | Related order (optional). |
olusturma | string (date-time) | Time. |
GameResult
One hand of POST /api/oyun/oyna (sonuc / sonuclar[]). Fields marked optional are left out when empty.
| Name | Type | Description |
|---|---|---|
oyun | string | Game key sent. |
bahis | integer | Credits staked on this hand (tumble bonus buy: bahis × bonus_fiyat). |
kazanc | integer | Payout (0 = lost). floor(bet × carpan), max 200000. |
net | integer | kazanc − bahis (negative on a loss). |
carpan | number | Total return multiplier of the hand (0 = lost, 1 = bet back). |
sonuc | string | Game-specific label: coin side, roulette colour, rps server hand, baccarat/dragontiger winner, slot/scratch/darts row, tumble theme. "" for other games. |
deger | number | Optional. dice roll, limbo/crash point, roulette number, lucky number, sicbo/ou7 total, baccarat player points, darts angle. |
indeks | integer | plinko pocket, wheel / moneywheel slice, cups cup, rps server hand (0 rock, 1 paper, 2 scissors), keno hits, horse winner, baccarat banker points; 0 otherwise. |
yol | integer[] | Optional. plinko path, one 0 (left) / 1 (right) per row. |
kartlar | integer[][] | Optional. baccarat [player, banker] / dragontiger [[dragon], [tiger]]. Card code 0–51: rank = code % 13 + 1 (1 = A … 13 = K), suit = floor(code / 13) (0 ♠, 1 ♥, 2 ♦, 3 ♣). |
sayilar | integer[] | Optional. keno draw (10 numbers), sicbo / ou7 dice, horse finish order. |
tur | TumbleRound | Optional. tumble only: the whole round for the animation. |
jackpot | {ad, tutar} | Optional. Jackpot hit on this request: tier and credits added. |
kredi | integer | Balance after the request. |
TumbleRound
GameResult.tur of a tumble slot. Grids are row-major arrays of sutun × satir cells (index = row × sutun + column). Cell values: 0 … 8 symbols (low to high pay; cluster games 0 … 6), 9 = scatter, 100 + v = multiplier orb ×v (e.g. 105 = ×5, scatter engine only).
| Name | Type | Description |
|---|---|---|
spinler[] | {a, ku, gc, k, sc, fs, ek}[] | Spins in order (base spin then free spins). a = cascade steps; ku = orb total applied (scatter engine); gc = global multiplier after the free spin; k = spin win (× bet); sc = scatters landed; fs = true for a free spin; ek = extra free spins won. |
spinler[].a[] | {g, w, k, m, d}[] | One cascade: g = grid before the win is removed; w = winning cell indexes; k = step win (× bet); m = cluster engine cell multipliers before the step (0 none, 1 marked, 2+ ×N); d = win breakdown [{s symbol, n count, k win × bet, c cluster multiplier}]. New symbols drop from the top after each win. |
fs_sayi | integer | Free spins played. |
toplam | number | Round win in multiples of the bet (kazanc = floor(bet × toplam)); capped at 5000. |
bonus | boolean | Optional. true for a bought bonus. |
sutun | integer | Columns (6 scatter, 7 cluster). |
satir | integer | Rows (5 scatter, 7 cluster). |
mod | "scatter" | "cluster" | Engine. |
GameSession
durum of POST /api/oyun/hamle and GET /api/oyun/oturum. Only the fields of the current game are present (optional fields are left out when empty).
| Name | Type | Description |
|---|---|---|
oyun | string | Game key. |
bitti | boolean | true = game over (payout added, session closed). |
bahis | integer | Hand bet. |
toplam | integer | Total staked (blackjack double adds the bet again). |
kazanc | integer | Payout when bitti (0 while playing). |
carpan | number | Playing: current cash-out multiplier (mines, hilo, chain). Finished: kazanc / toplam. |
sonuc | string | When bitti: win | lose | push | blackjack | bust | cashout, or the video poker hand name (royal_flush … jacks_better; lose when nothing). |
sonraki | number | mines / chain: multiplier after one more safe step. |
kredi | integer | Balance after the move (0 in GET /api/oyun/oturum). |
jackpot | {ad, tutar} | Jackpot hit at basla. |
oyuncu | integer[] | blackjack: player cards (card codes, see GameResult.kartlar). |
kurp | integer[] | blackjack: dealer cards; [upcard, -1] while playing (-1 = face down). |
oyuncu_t | integer | blackjack: player total. |
kurp_t | integer | blackjack: dealer total (upcard only while playing). |
ikikat_ok | boolean | blackjack: double is allowed now. |
mayin | integer | mines: number of mines. |
acik | integer[] | mines: opened cells (0–24). |
mayinlar | integer[] | mines: mine cells, only when bitti. |
kart | integer | hilo: current card code. |
gecmis | integer[] | hilo: all cards so far. |
tahmin | string[] | hilo: guesses so far (yuksek | dusuk | atla). |
p_yuksek | number | hilo: chance (0–1) that "yuksek" wins on the current card. |
p_dusuk | number | hilo: chance (0–1) that "dusuk" wins. |
el | integer[] | videopoker: the 5 cards (after cek: the final hand). |
el_adi | string | videopoker: current hand name ("" = no win). |
risk | string | chain: difficulty. |
n | integer | chain: boxes per row (kule) / odds denominator (tek). |
k | integer | chain: safe boxes per row (chance per step k / n). |
max_adim | integer | chain: steps until automatic cash-out. |
satirlar | boolean[][] | chain: revealed rows (true = safe box); "tek" games have one value per step. |
secimler | integer[] | chain: box picked in each row. |
GameFeed
genel of GET /api/oyun/akis. Player names are masked ("Al***").
| Name | Type | Description |
|---|---|---|
son | FeedRow[] | Last 30 hands of all players. |
buyuk | FeedRow[] | Top 10 wins of the last 24 hours. |
liderler | Lider[] | Top 10 net winners of the last 24 hours ({oyuncu, net, el, harcama}). |
rekor | FeedRow[] | Top 20 wins of the last 30 days. |
jackpot | JackpotPool[] | The four jackpot tiers. |
jackpot_son | JackpotWin[] | Last 20 jackpot winners. |
donem | object | Statistics for ?donem: {donem, kazananlar[], oynayanlar[], kaybedenler[] (Lider: oyuncu, net, el, harcama, kazanc, en_iyi, favori, son; top 20 each), oyunlar[] ({oyun, el, oyuncu, harcama, odeme, rtp, en_iyi, en_buyuk, kazanma} per game, rtp = real return), toplam {el, harcama, odeme, oyuncu}}. |
gun | object | Last 24 hours: {el (hands), harcama (credits bet), oyuncu (players)}. |
FeedRow | {oyuncu, oyun, bahis, kazanc, carpan, zaman} | oyun is the stored key: game key, "tb-<theme>" for tumble, "zn-<key>" for chain games; slot themes are stored as "slots". |
JackpotPool
One jackpot tier. A hit pays carpan × bet (bet counted up to 2000) + the progressive pool × min(1, bet / 100) — the whole pool at a bet of 100 or more. Every bet adds 0.25% to each pool. One roll per request; tiers are checked from grand down.
| Name | Type | Description |
|---|---|---|
ad | "grand" | "major" | "minor" | "mini" | Tier. |
carpan | integer | Fixed multiplier of the bet: 500 / 150 / 50 / 10. |
havuz | integer | Current progressive pool in credits. |
bolen | integer | Chance per hand is 1 / bolen (200000 / 30000 / 12500 / 4000). |
JackpotWin | {oyuncu, ad, tutar, oyun, bahis, zaman} | Winner row (jackpot_son): masked name, tier, credits won, game, bet, time. |
Tournament
turnuva of GET /api/oyun/turnuva.
| Name | Type | Description |
|---|---|---|
bas | string (date-time) | Week start (Monday 00:00 UTC). |
bitis | string (date-time) | Week end (next Monday 00:00 UTC) — prizes are paid then. |
min_bahis | integer | Minimum bet of a qualifying hand (100). |
oduller | integer[] | Prize per place 1–10: 25000, 10000, 5000, 1000 × 7. |
liderler | TournamentRow[] | Top 10: {sira, oyuncu, carpan, oyun, bahis, zaman, odul}. |
benim | TournamentRow | Signed-in user's place (left out when none). |
gecen | TournamentRow[] | Last week's paid winners. |
Streak
seri of GET /api/seri and POST /api/seri/al.
| Name | Type | Description |
|---|---|---|
seri | integer | Last claimed day 1–7 (0 = none or broken). |
bugun | boolean | true = today's bonus already claimed. |
sonraki | integer | Day (1–7) that the next claim pays. |
oduller | integer[] | Bonus per day: 100, 200, 300, 500, 750, 1000, 2500. |
sifirlama | string (date-time) | Next UTC day start (next claim possible). |
kredi | integer | POST only: new balance. |
kazanilan | integer | POST only: credits added. |
Order status
pending → queued → in_progress → completed. Final states: completed, canceled, failed. Responses also carry the internal name in durum.
| status | durum | Meaning |
|---|---|---|
pending | beklemede | Created, not yet sent to delivery. |
queued | kuyrukta | Accepted by the delivery engine, waiting to start. |
in_progress | calisiyor | Delivering. biten_sayac grows. |
completed | tamamlandi | Finished (final). |
partial | kismi | Finished, but only part was delivered (final). Credits for the undelivered part are refunded automatically. |
canceled | iptal | Canceled (final). |
failed | hata | Could not be dispatched; credits refunded (final). |
Errors
Every error has an HTTP status and a body like { "kod": "kredi_yok", "error": "not enough credits", "hata": "not enough credits" }. Show your own text based on kod — this is how you translate the API into any language.
| kod | HTTP | Meaning | What to do |
|---|---|---|---|
giris_gerekli | 401 | Sign in required (or the free no-sign-in quota is used up for this channel/visitor). | Open the sign-in dialog: signed-in users order with credits. |
kanal_cooldown | 429 | This channel already received a free order in the last hour. | Sign in or try again later. |
oturum_yok | 401 | Token missing, invalid or expired. | Delete the token, ask to sign in again. |
kullanici_yok | 401 | Account no longer exists. | Delete the token. |
browser_required | 403 | Not a real browser request (server-side script). | Call the API from a web page. |
not_public | 403 | Endpoint not available to external sites. | Do not use it. |
captcha_yok | 400 | hCaptcha token missing (captcha_token in /api/order, X-FS-Captcha header for invite code / channel credits). | Show the hCaptcha frame and send its token. |
captcha_ret | 400 | hCaptcha token invalid, expired or already used. | Show the hCaptcha frame again. |
kredi_yok | 402 | Not enough credits. | Show the balance, invite link and next refill time. |
min_kredi | 402 | Balance below the service minimum. | Same as above. |
referans_gerekli | 403 | Service needs more invites ("x/y" in message). | Show the invite link. |
rate_limit | 429 | Too many requests. | Wait and retry with backoff. |
gecersiz_govde | 400 | Invalid JSON or unknown field. | Fix the request body. |
gecersiz_tip | 400 | Unknown service type. | Use a tip from /api/link-servisler. |
hedef_yok | 400 | hedef_kanal missing. | Resolve the channel first. |
link_gecersiz | 400 | Link does not match the platform. | Ask for a valid post URL. |
servis_yok | 400 | Service disabled. | Hide it. |
bos_girdi | 400 | Empty input. | Validate before sending. |
cozulemedi | 422 | Channel/video not found. | Ask for another link. |
kanal_yok | 404 | Channel not found. | — |
video_yok | 404 | Video not found. | — |
siparis_yok | 404 | Order not found. | — |
referans_gecersiz | 404 | Invite code not found. | — |
referans_kendi | 400 | Own invite code. | — |
referans_var | 409 | Invite already used. | — |
referans_limit | 429 | Invite limit for this network/account. | — |
kanal_alinamadi | 502 | Could not read the user's channels. | Ask to sign in again. |
device_hata | 502 | Sign-in could not start. | Retry. |
yetersiz_kredi | 402 | Games / raffle: balance lower than the bet. Sent as { "ok": false, "hata": "yetersiz_kredi", "kredi": <balance> } (code in hata, no kod). | Show the balance, lower the bet, offer the wheel / streak / invite link. |
bahis | 400 | Games: bet outside 10–2000 (or tumble bonus price above 50000). | Clamp the bet input to min_bahis / max_bahis. |
gecersiz | 400 | Games: unknown game, invalid parameter for that game (secim, hedef, x, satir, risk, adet, mayin, hucre, tut) or a move not allowed now; raffle: adet outside 1–50. | Check the game catalog; disable buttons that are not allowed. |
oturum_yok_oyun | 409 | Step-by-step game: no open session for this game (move sent before basla or after the game ended). | Call GET /api/oyun/oturum or start with hamle basla. |
alindi | 409 | Daily streak already claimed today. Sent as { "ok": false, "hata": "alindi" }. | Show a countdown to sifirlama. |
cark_bekle | 429 | Hourly wheel already spun this hour. Sent as { "ok": false, "hata": "cark_bekle", "sonraki", "kredi" }. | Show a countdown to sonraki. |
limit | 400 | Raffle: more than 50 tickets today. Sent as { "ok": false, "hata": "limit", "benim_bilet" }. | Show how many tickets are left (50 − benim_bilet). |
db_hata | 500 | Temporary server error. | Retry later. |
Rate limits & security
| Scope | Limit |
|---|---|
| All /api calls | 6 requests/second per IP (burst 60). Abusive IPs are banned automatically for 60 minutes. |
| Heavy calls (resolve, search, order, channel, video, device start) | 30 per minute per IP (burst 15). |
| Per user (external sites) | 90 requests per minute. |
| Orders per user (external sites) | 30 per hour, plus the credit balance. |
| Free orders without sign-in | 100 subscribers once per channel; 1 per hour per visitor (IP + fingerprint); 1 per hour per channel; shared hourly cap for all external sites. |
| Per site (Origin) | 1500 requests per minute. |
| Sign-in starts | 12 per IP per 10 minutes. |
| Resolve | 40 per minute per IP. |
| Games: hands (POST /api/oyun/oyna) | 60 per minute per user (429 rate_limit), plus the 90 requests per minute per user for external sites. |
| Games: moves (POST /api/oyun/hamle) | 150 per minute per user (429 rate_limit). |
| Games: bets | 10–2000 credits per hand; plinko up to 10 balls per request (bet × balls); tumble bonus buy max 50000 credits; payout max 200000 per hand (tumble round max 5000× bet). |
| Games: open sessions | One open session per user per step-by-step game; untouched sessions close after 24 hours (bet lost). |
| Games without sign-in | GET /api/oyun, GET /api/oyun/akis and GET /api/oyun/turnuva only. Poll the jackpot ticker (?hafif=1) every 5–15 s, not faster. |
| Wheel / streak / raffle | Wheel: 1 spin per clock hour (UTC). Streak: 1 claim per UTC day. Raffle: max 50 tickets (100 credits each) per user per UTC day. |
- On
429 rate_limitwait a few seconds and retry with exponential backoff; do not loop. - Poll order progress every 8–15 seconds, never faster. Stop polling on final states.
- Cache
/api/link-servislerand/api/sitefor the page session. - Never ship secrets. The token belongs to the visitor; store it only in their browser.
- Server-side requests, headless browsers and bots are blocked; repeated abuse bans the IP automatically.
Build a full site
These are the exact pages of our Blogger theme. Use hash routes (#/channel/…) so it works on any static host, including Blogger.
Header (every page)
- On load: if a token is stored call GET /api/auth/me. 200 → show avatar + name; 401 → delete the token, show "Sign in with Google" (no captcha for sign-in).
- Show the balance from GET /api/kredi (kredi.kredi). Refresh it after each order.
- Optional: a search box that sends any link/@handle/name to your channel/video page.
Home page with order form
- GET /api/link-servisler → build service tabs from items with aktif = true (YouTube: sub, like, comment, comment_like; others when active).
- Input "channel or video link" → POST /api/resolve. tip = "kanal": show avatar, name, abone_sayi, videolar; tip = "video": show the video card.
- If alternatifler is not empty show "Not this channel?" with those channels.
- Quantity input limited by min_adet / max_adet; show cost = adet × kredi_carpani and the user's balance. Lock services where min_referans > davet_sayisi.
- Send → open the hCaptcha frame (https://igsub.me/captcha/frame.html in an iframe), wait for the postMessage token, then POST /api/order with captcha_token. On success go to the order page with order_id. On error show the message for kod (kredi_yok → invite link + next refill time, captcha_ret → show the check again).
- Optional live feed: GET /api/son-siparisler every 30 s ("Al*** received 100 subscribers 42 s ago").
Channel page (e.g. #/channel/UC…)
- GET /api/channel/{channelId} → channel header (avatar, banner, abone_sayi, video_sayi, aciklama) + first 30 videos.
- "Load more": GET /api/channel/{channelId}/videos?offset=30. Shorts tab: ?sekme=shorts then pass devam as continuation.
- Subscriber order form on top (tip sub, hedef_kanal = channelId); clicking a video opens the video page.
Video page (e.g. #/video/VIDEO_ID)
- GET /api/video/{videoId} → title, thumbnail or YouTube embed (https://www.youtube.com/embed/VIDEO_ID), views, duration, channel card.
- Order buttons for like, comment, comment_like (hedef_kanal = video.channel_id, hedef_video = video id) and sub.
Order tracking page (e.g. #/order/ORDER_ID)
- GET /api/order/{order_id} every 10 s → progress bar biten_sayac / adet, status badge, start count.
- GET /api/order/{order_id}/events → timeline. Stop polling when status is completed, canceled or failed.
- The order_id link can be shared; it only shows progress, never personal data.
Account page
- GET /api/kredi → balance, gunluk_hak, sonraki_sifirlama (countdown), referans_kod (invite link https://igsub.me/?ref=CODE + share buttons), davet_sayisi.
- Button "Claim channel credits" → hCaptcha frame → POST /api/kredi/kanal-topla with X-FS-Captcha (once per hour).
- Field "Have an invite code?" → hCaptcha frame → POST /api/referans/uygula with X-FS-Captcha.
- Tables: GET /api/siparislerim (orders, link to order page with public_token) and GET /api/kredi/hareketler (credit history).
- Sign out = delete the stored token.
Games page (e.g. #/games)
- Jackpot ticker for everyone: GET /api/oyun/akis?hafif=1 every 10 s → four tiers (ad, carpan × bet + havuz pool) and the last winners (jackpot_son). Stop polling when the page closes.
- Weekly tournament for everyone: GET /api/oyun/turnuva → top 10 (sira, oyuncu, carpan, oyun, odul), the user's place (benim) and a countdown to bitis. Explain: best multiplier with a bet ≥ 100 counts.
- Daily streak (signed in): GET /api/seri → 7 boxes from oduller, highlight sonraki, disable the button when bugun is true; POST /api/seri/al → show +kazanilan and the new kredi.
- Quick games (signed in): bet input 10–2000 and POST /api/oyun/oyna, e.g. { oyun: "coin", secim: "heads" }, { oyun: "dice", hedef: 50 }, { oyun: "limbo", x: 2 }. Show win/lose, carpan, kazanc, net and update the header balance from sonuc.kredi; show a banner when sonuc.jackpot is set.
- Step-by-step games: on open call GET /api/oyun/oturum?oyun=mines to resume; POST /api/oyun/hamle with hamle basla → moves → until durum.bitti.
- Errors by kod || hata: yetersiz_kredi (402, offer the wheel/streak/invite link), bahis (400), gecersiz (400), rate_limit (429, slow down), oturum_yok / giris_gerekli (401, sign in).
- Link to the full animated games: https://igsub.me/{lang}/games ("Play all 80+ games on igsub.me").
Example page
Our Blogger theme as one HTML file — the same design and the same features: home page with service tabs and live deliveries, channel page with videos and Shorts, video page, order tracking with timeline, account page with credits, invites and history, Google sign-in, hCaptcha check, dark mode, header search and popular searches, and a Games page (live jackpots, weekly tournament, daily streak, coin flip / dice / limbo). Upload it as index.html anywhere and change “My Site” to your name. Built-in languages: English and Turkish (window.FS_DIL = 'tr'); all texts are inside the script.
Node.js version (React + Vite)
The same full site as a modern React + Vite project: home page with services, channel lookup, channel and video pages, live order tracking, account page (credits, history, invite code, channel credits), 24-hour live delivery feed, 100 free subscribers without sign-in, a Games page (live jackpots, weekly tournament, daily streak, coin flip / dice / limbo), dark and light theme and several languages. Set your site name and your invite code in .env (VITE_SITE_NAME, VITE_OWNER_REF), then:
npm install
npm run dev # http://localhost:3000
npm run build # static files in ./dist (upload anywhere)
npm start # or serve ./dist with the included Node.js serverNode.js 20 or newer. The included server.js only serves files — all API calls still run in the visitor's browser (server-side calls are rejected).
FAQ
Is the API really free?
Yes. There are no fees, no paid plans and no usage billing — for you and for your visitors. Orders use free credits that refill every hour.
Can I earn credits with my site?
Yes. Pass your invite code to /api/auth/device/start?ref=YOURCODE (or set window.FS_REF in the example page). Every new user who signs in on your site gives you +1000 credits (max 30 per day).
Do I need an API key?
No. There are no keys. The visitor signs in with Google on your page and uses their own credits.
Can I call it from PHP / Node / Python / cURL?
No. Only real browsers are accepted (403 browser_required). Build your page in HTML + JavaScript; the visitor's browser calls the API.
Does it work on Blogger / WordPress / Wix / GitHub Pages?
Yes — anywhere you can add HTML and JavaScript. All calls go to https://igsub.me with CORS.
Can visitors order without signing in on my site?
Yes, but only the free 100 YouTube subscribers: once per channel, max 1 per hour per visitor, with hCaptcha. Likes, comments, other platforms and bigger orders need Google sign-in (free credits).
Is there a captcha?
Yes: every order, invite code and channel-credit claim needs hCaptcha (sign-in does not). It runs inside a small igsub.me frame (https://igsub.me/captcha/frame.html), so you need no captcha keys — you receive the token via postMessage and send it (captcha_token for orders, X-FS-Captcha header for the others).
Which Google accounts work?
@gmail.com accounts.
How long is a session valid?
30 days. On 401 oturum_yok ask the user to sign in again.
Is there an invite reward?
Yes: every friend who signs in with the user's invite code gives that user +1000 credits.
Which language are responses in?
Errors and status are English (kod is language-neutral). Translate your UI freely.
Is there a sandbox?
No. Use a test channel and small quantities; credits are free.
Can my site offer the games?
Yes. GET /api/oyun, /api/oyun/akis and /api/oyun/turnuva work without sign-in; signed-in visitors can play every game, claim the daily streak, spin the hourly wheel and buy raffle tickets with their free credits (see "Games & jackpots").
Can credits won in games be cashed out?
No. Credits are free and are not money: they can never be bought, sold or withdrawn — only spent on orders or games. Every game returns at most 97%.
Where is the machine-readable spec?
OpenAPI 3.1: https://igsub.me/developers/openapi.json — plain text / Markdown for AI assistants: https://igsub.me/developers/llms.txt
Changelog
v1.3.0 2026-10-30
- New "Games & jackpots" API: GET /api/oyun (rules and payout tables), POST /api/oyun/oyna (single-request games: coin, dice, limbo, crash, plinko, wheel, roulette, slots with 12 themes, 30 tumble slots, keno, sic bo, baccarat and more), POST /api/oyun/hamle + GET /api/oyun/oturum (step-by-step games: blackjack, mines, hi-lo, video poker and 14 chain games), GET /api/oyun/akis (live feed, statistics and jackpot pools).
- Four jackpot tiers on every game: Grand 500× / Major 150× / Minor 50× / Mini 10× of the bet (bet counted up to 2000) plus a progressive pool that grows with every bet (whole pool at bet ≥ 100).
- New "Wheel, streak, raffle & tournament" API: hourly lucky wheel (GET /api/cark, POST /api/cark/cevir), 7-day daily streak (GET /api/seri, POST /api/seri/al), daily raffle (GET /api/cekilis, POST /api/cekilis/bilet) and the weekly tournament (GET /api/oyun/turnuva).
- GET /api/oyun, GET /api/oyun/akis and GET /api/oyun/turnuva work without sign-in on external sites; all other game calls need the session token.
- Game limits: bets 10–2000 credits, 60 hands per minute per user (POST /api/oyun/oyna), 150 moves per minute (POST /api/oyun/hamle). Credits are free and can never be bought or cashed out; every game returns at most 97%.
- New game catalog section, data models (GameResult, TumbleRound, GameSession, GameFeed, JackpotPool, Tournament, Streak) and error codes (yetersiz_kredi, bahis, gecersiz, oturum_yok_oyun, alindi, cark_bekle, limit).
- Example page and Node.js version: new Games page (live jackpots, weekly tournament, daily streak, coin flip / dice / limbo demo).
v1.2.0 2026-10-25
- Sign-in (POST /api/auth/device/start) no longer needs hCaptcha. hCaptcha stays required for orders, invite codes and channel credits.
- Admin statistics per external site (requests, sign-ins, orders).
- GET /api/son-siparisler now returns every order completed in the last 24 hours (up to 100).
- New order status "partial" (durum "kismi"): finished with only part delivered; unused credits are refunded automatically.
- New download: Node.js version of the example site (React + Vite, /developers/nodejs-starter-kit.zip).
v1.1.0 2026-10-25
- hCaptcha is required for every order (captcha_token) and for sign-in start, invite codes and channel credits (X-FS-Captcha header). Solved in the igsub.me frame https://igsub.me/captcha/frame.html — no keys needed.
- Site owners can pass their own invite code (?ref=CODE / window.FS_REF) and earn +1000 credits per new user who signs in on their site.
- The example page (starter-kit.html) is now identical to our Blogger theme.
- Cross-site API is served only from https://igsub.me.
- Free without sign-in: 100 YouTube subscribers once per channel (resolve, channel, video, order and tracking work without sign-in; hCaptcha required).
- The hCaptcha frame opens in the visitor's browser language by default (?hl=auto); ?hl=xx forces a language.
v1.0.0 2026-10-25
- First public release: no API key, browser-only CORS, Google sign-in, English errors (kod + error) and English order status.
For AI assistants
If you are an AI model helping someone build a site with this API: read /developers/llms.txt (full reference in Markdown) or import /developers/openapi.json (OpenAPI 3.1). Generate browser JavaScript only (fetch with X-FS-Mode: token and Authorization: Bearer), never server-side code, and never invent API keys.
Prefer the hosted tool? Use iGSub directly.