TikTok Events API -raja: 1 000 pyyntöä/s (2026)

Tarkistettu viimeksi · lähteet on lueteltu sivun lopussa

TikTok rajoittaa jokaista endpointia erikseen minuutin liukuvaa ikkunaa vasten. Direct Post sallii 6 pyyntöä minuutissa user access tokenia kohden, Query Creator Info 20, Get Post Status 30, ja käyttäjien ja videoiden lukuendpointit (/v2/user/info/, /v2/video/query/, /v2/video/list/) 600 kukin. Rajan ylittäminen palauttaa HTTP 429 -vastauksen virhekoodilla rate_limit_exceeded. Events API on erillinen järjestelmä erillisellä hostilla: 1 000 pyyntöä sekunnissa, sama kaikilla sovellustasoilla, ja kuristettaessa se vastaa koodilla 40100.

Mikä on kunkin TikTok API -endpointin raja?

Rajat asetetaan ja niitä valvotaan endpointeittain, ei yhtenä yhteisenä budjettina. Direct Postin loppuun käyttäminen ei hidasta Get Post Statusta, eikä päinvastoin.

EndpointRajaMitä se tarkoittaa käytännössä
Direct Post (/v2/post/publish/video/init/)6 pyyntöä / minuutti per user access tokenSitova raja kaikille, jotka julkaisevat useille tileille. Se on tokenikohtainen eli yhdistettyä tiliä kohden — kymmenen tiliä eivät jaa kuutta pyyntöä, vaan jokaisella on omat kuusi.
Query Creator Info20 pyyntöä / minuutti per user access tokenKutsutaan ennen jokaista julkaisua, koska julkaisunäkymän on näytettävä tekijän todelliset yksityisyysvaihtoehdot. Siksi julkaisu vie vähintään kaksi kutsua, ei yhtä.
Get Post Status30 pyyntöä / minuutti per user access tokenKyselyä (polling). Kolmekymmentä minuutissa kuulostaa runsaalta, kunnes kyselet kymmentä tiliä kahden sekunnin välein — se tekee 300.
/v2/user/info/600 pyyntöä / minuuttiProfiilien luku.
/v2/video/query/600 pyyntöä / minuuttiTiettyjen videoiden mittarit.
/v2/video/list/600 pyyntöä / minuuttiSivutettu lista tekijän videoista.
Julkaistut rajat, luettu TikTokin kehittäjädokumentaatiosta 22. syyskuuta 2026.

Miten ikkuna lasketaan, ja mitä tapahtuu, kun raja ylittyy?

Laskenta käyttää minuutin liukuvaa ikkunaa, ei kiinteää kellominuuttia. Kuuden julkaisun ryöppy klo 10:00:59 ei nollaudu klo 10:01:00 — sitä lasketaan klo 10:01:59 asti.

Rajan yli mentäessä API vastaa HTTP 429 virhekoodilla rate_limit_exceeded. TikTok kertoo, että rajoja voi pyynnöstä nostaa sen tukisivun kautta, ja pyynnöt käsitellään tapauskohtaisesti.

Käytännön seuraus useille tileille julkaisevalle: 429:n jälkeisen uusintayrityksen on odotettava, ei toistettava heti. Välitön uusinta pidentää juuri sitä ikkunaa, josta se yrittää päästä pois.

Mikä on TikTok Events API:n raja pyyntöinä sekunnissa?

Tuhat sekunnissa, ja luku on sama jokaiselle kehittäjäsovellukselle — tämä on ainoa kohta, jossa TikTok ei pakota hakemaan lisää.

Kyseessä on eri API kuin kaikki yllä olevat endpointit, ja juuri tähän moni kompastuu. Content Posting -endpointit ovat osoitteessa developers.tiktok.com, ja niitä lasketaan minuuttikohtaisesti user access tokenia kohden. Events API on osa Marketing API:a osoitteessa business-api.tiktok.com, ja sitä lasketaan QPS-, QPM- ja QPD-arvoina kehittäjäsovellustasi vasten. Kaksi hostia, kaksi järjestelmää, kaksi virhekoodia: Marketing API vastaa "code": 40100, kun kehittäjä-API vastaa HTTP 429.

Sovelluksesi on lisäksi yhdellä neljästä globaalista tasosta — Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50 — ja jokainen sovellus aloittaa Basicista. Events-endpointit on nimenomaisesti vapautettu tästä portaikosta: TikTok kertoo, ettei Events API:lle tarvitse hakea tasomuutosta, koska raja on sama kaikilla tasoilla. Alla olevat 1 000 QPS ovat siis sitä, mitä upouusi sovellus saa ensimmäisestä päivästä lähtien.

EndpointRajaMitä se tarkoittaa käytännössä
Web Events (/pixel/track/) ja /pixel/batch/1 000 / sekunti · 600 000 / minuutti · 86 400 000 / päiväVerkkokonversiot selaimesta ja palvelinpuolelta. Päiväluku on tasan 1 000 × 86 400, joten sekuntiraja on ainoa, johon voit realistisesti törmätä.
App Events (/app/track/) ja /app/batch/1 000 / sekunti · 600 000 / minuutti · 86 400 000 / päiväMobiilisovellusten konversiot.
Offline Events (/offline/track/) ja /offline/batch/1 000 / sekunti · 600 000 / minuutti · 86 400 000 / päiväMyymälä- ja CRM-konversiot, jotka lähetetään jälkikäteen.
/event/track/1 000 / sekunti · 600 000 / minuutti · 86 400 000 / päiväEvents API 2.0:n endpoint.
Streaming API10 000 / sekunti Basic-tasolla, enintään 50 000 Ultimate-tasollaAinoa tapahtumapuolen raja, joka todella seuraa tasoportaikkoa.
Events API:n rajat, samat tasoilla Basic, Advanced, Premium ja Ultimate. Luettu TikTokin business-API-dokumentaatiosta 27. syyskuuta 2026.

Miksi kymmenelle tilille julkaiseminen ei kestä kymmenen kertaa kauemmin?

Koska jokainen yllä oleva raja koskee user access tokenia, ja yksi token on yksi yhdistetty tili. Kymmenen tiliä on kymmenen toisistaan riippumatonta ämpäriä, joissa kussakin on kuusi julkaisua minuutissa.

Jonoon joutuu sen sijaan oma infrastruktuurisi: yksi videotiedosto ladattuna kymmenen kertaa on kymmenen siirtoa. Ensimmäisenä vastaan tuleva raja ei ole juuri koskaan TikTokin, vaan kaistanleveys.

Usein kysyttyä

Ovatko TikTokin API-rajat sovellus- vai käyttäjäkohtaisia?
Content Posting -endpointit on dokumentoitu user access tokenia kohden — eli yhdistettyä tiliä kohden. TikTok ei julkaise näille endpointeille erillistä koko sovelluksen kattoa, ja kertoo, että rajat asetetaan ja niitä valvotaan erikseen kullekin API:lle.
Minkä virheen TikTok palauttaa, kun raja ylittyy?
HTTP-tilakoodin 429, ja vastauksen rungossa virhekoodin rate_limit_exceeded.
Voiko TikTokin API-rajoja nostaa?
Kyllä. TikTokin dokumentaation mukaan korkeampia rajoja voi pyytää sen tukisivun kautta, ja jokainen pyyntö käsitellään.
Mikä on TikTok Events API:n raja sekunnissa?
1 000 pyyntöä sekunnissa, 600 000 minuutissa ja 86 400 000 päivässä, yhtä lailla endpointeille /event/track/, Web Events, App Events ja Offline Events. TikTok soveltaa samaa lukua kaikilla neljällä sovellustasolla ja kertoo, ettei Events API:lle tarvitse hakea korotusta.
Onko Events API:n raja sama kuin Content Posting API:n raja?
Ei, eivätkä ne ole edes sama järjestelmä. Content Posting on dokumentoitu osoitteessa developers.tiktok.com, sitä lasketaan minuuttikohtaisesti user access tokenia vasten, ja se vastaa HTTP 429 koodilla rate_limit_exceeded. Events API kuuluu Marketing API:in osoitteessa business-api.tiktok.com, sitä lasketaan pyyntöinä sekunnissa, minuutissa ja päivässä kehittäjäsovellustasi vasten, ja se vastaa koodilla 40100.
Montako TikTok-videota voin julkaista minuutissa API:n kautta?
Kuusi yhdistettyä tiliä kohden, koska Direct Post sallii 6 pyyntöä minuutissa user access tokenia kohden. Kymmenellä yhdistetyllä tilillä se tekee kuusikymmentä, koska jokaisella tilillä on oma rajansa.

Lähteet

Nämä luvut ovat peräisin toisen yrityksen dokumentaatiosta, joka voi muuttua ilman ennakkovaroitusta ja jota mikään tässä ei tarkista automaattisesti. Siksi jokaisessa lähteessä on päivä, jolloin se luettiin. Tämän sivun lähteet luetaan uudelleen joka neljännesvuosi.

Miten tämä sivu tehtiin: laadittu tekoälyn avulla tällä sivulla luetelluista lähteistä, luettu .