TikTok API -opas vuodelle 2026: sovelluksesta ensimmäiseen julkaisuun
Kehittäjäsovelluksesta ensimmäiseen TikTok-julkaisuun vuonna 2026 rekisteröidy yrityksenä TikTokin API for Business -rajapintaan, luo sovellus TikTok Accounts -oikeudella, anna tilin omistajan valtuuttaa se, vaihda koodi 24 tunnin access-tokeniin ja kutsu endpointia /business/video/publish/ vahvistetulla video-URL-osoitteella. Seuraa sen palauttamaa share_id-tunnusta, kunnes tila on PUBLISH_COMPLETE, ja lisää sen jälkeen kommentit, webhookit ja insightit.
easyCoexistence hoitaa kehittäjäpuolen puolestasi omalla API for Business -sovelluksellaan ja vahvistetulla mediareitillään.
Milloin TikTok vastaa kehittäjärekisteröintiin, joka vaatii vahvistetun yritysdomainin sähköpostiosoitteen ja yrityksen verkkosivuston.
Päivämäärä, josta alkaen uudet sovellukset ja TikTok Accounts -oikeutta sisältävät scope-pyynnöt vaativat ensin Accounts API Access Application Form -lomakkeen.
Omistajan hyväksynnän palauttaman auth_code-koodin elinikä; se toimii vain kerran vaihdossa osoitteessa /tt_user/oauth2/token/.
Mitä molemmat publish-endpointit palauttavat, välitetään publish_id-kenttänä osoitteeseen /business/publish/status/ julkaisun seuraamiseksi.
Katselutila, jonka TikTok asettaa Content Posting API:n kautta julkaistulle sisällölle sovelluksilta, joita se ei ole vielä auditoinut.
Kutsujen määrä valtuutettua tiliä kohden kullakin Accounts API -endpointilla, sovelluksen 600 kutsun minuuttibudjetin sisällä Basic-tasolla.
Mikä on polku TikTok-kehittäjäsovelluksesta ensimmäiseen julkaisuun?
Viisi vaihetta TikTokin API for Business -rajapinnassa, jokaisella oma tarkistus tai tarkastus. Rekisteröinti ja sovelluksen tarkistus tehdään kerran, valtuutus kerran jokaiselle sovelluksen hallinnoimalle tilille, ja kaksi viimeistä vaihetta toistuvat jokaisen julkaisun kohdalla. Alla vaiheet järjestyksessä, kunkin endpoint, kenttä ja raja mukaan lukien:
Mitä TikTok-rajapintaa tarvitset?
Sitä, joka vastaa tehtävääsi. TikTokilla on kaksi kehittäjäportaalia: business-api.tiktok.com API for Business -rajapintaa varten ja developers.tiktok.com TikTok for Developers -palvelua varten, johon kuuluvat Content Posting, Display ja Research API:t. Yritysten omistamien tai palvelemien tilien julkaisujen, kommenttien ja insightien hallintaan tarvitset API for Business -rajapinnan, sillä siinä ovat kommenttien endpointit ja kommenttien webhookit:
Mitä TikTok-tilejä sovellus voi hallita?
Sekä henkilökohtaisia että yritystilejä. TikTokin Accounts API erottaa kolme tasoa: General TikTok Account, jonka jokainen aloittaa; tili, jolla on Advanced Access ja joka on linkitetty TikTok for Business -tiliin tai vahvistamattomaan Business Centeriin; sekä Verified Business Account. Julkaisu- ja kommenttiendpointit eivät nimeä tilitasoa, mutta eräät insight-kentät, Mentions API ja Business Messaging API vaativat Advanced Accessin tai Verified Business Accountin.
Miten rekisteröidyt ja saat sovelluksen hyväksytyksi?
Yrityksenä TikTok for Business Developers -portaalissa kolmessa vaiheessa, jotka TikTok tarkistaa:
- Kehittäjärekisteröinti: vahvistettu yritysdomainin sähköpostiosoite ja julkinen yrityksen verkkosivu yrityksen omistamalla domainilla. TikTok vastaa kolmessa arkipäivässä eikä ota vastaan yksittäisiä kehittäjiä.
- Accounts API Access Application Form: vaaditaan 20. maaliskuuta 2026 lähtien ennen uutta sovellusta tai scope-laajennusta, joka sisältää TikTok Accounts -oikeuden.
- Kehittäjäsovellus: sen tarkoitetut käyttötavat ja käyttöoikeudet, uudelleenohjaus-URL ja TikTok Accounts -oikeus, tarkistetaan 2–3 arkipäivässä, ja kehittäjällä voi olla enintään viisi sovellusta.
Mitä oikeuksia ja scopeja sovellus tarvitsee?
Kahta tasoa, joita antavat eri ihmiset. Kehittäjäsovellus pitää hallussaan TikTok Accounts -oikeuksia, jotka valitaan Scope of permission -kohdasta ja joiden TikTok tarkistaa, ja jokainen niistä avaa endpointteja. Tilin omistajan hyväksyntä asettaa scopet access-tokeniin, ja ne avaavat kenttiä ja ominaisuuksia, kuten user.insights päivittäisille tilimittareille, video.list ja video.insights julkaisujen tiedoille, video.upload luonnoksille ja comment.list kommentti-webhookille. /tt_user/token_info/get/ listaa tokenin kantamat scopet.
Miten tili valtuuttaa sovelluksen, ja mitä tokenit tekevät?
Omistaja avaa sovelluksen TikTok-tilin haltijan valtuutus-URL-osoitteen, joka löytyy kohdasta My Apps, App Detail, Basic Information, ja hyväksyy sen oikeudet. TikTok ohjaa uudelleenohjaus-URL-osoitteeseen auth_code-koodin kanssa, ja palvelin vaihtaa sen osoitteessa /tt_user/oauth2/token/ access-tokeniin, jonka voimassaoloaika on 24 tuntia, refresh-tokeniin, jonka voimassaoloaika on yksi vuosi, ja tilin open_id-tunnukseen. Tokeni kulkee Access-Token-otsakkeessa ja open_id business_id-kentässä jokaisessa Accounts API -kutsussa, ja /tt_user/oauth2/refresh_token/ uusii tokenin.
Miten julkaiset video- ja kuvapostauksen?
Kummallakin yhdellä POST-pyynnöllä, URL-osoitteista, jotka TikTok lataa itse, ja domainista tai URL-etuliitteestä, joka on vahvistettu sovellukselle. /business/video/publish/ ottaa business_id, video_url ja post_info-kentän, johon kuuluvat kuvateksti ja brändimerkinnät ja joka vaaditaan, vaikka se olisi tyhjä. /business/photo/publish/ ottaa enintään 35 photo_images-kuvaa JPG-, JPEG- tai WebP-muodossa ja post_info-kentän, jonka privacy_level on pakollinen. Molemmat vastaavat share_id-tunnuksella, ja TikTok julkaisee enintään kuusi postausta minuutissa ja 15 päivässä tiliä kohden kummankin endpointin kautta.
Mistä tiedät, että postaus on julkaistu?
Kysy /business/publish/status/ -endpointilta business_id ja share_id publish_id-kenttänä, tai tilaa sovellus julkaisun webhookeihin. Tila siirtyy tilasta PROCESSING_DOWNLOAD tilaan PUBLISH_COMPLETE tai pysähtyy tilaan FAILED syyllä, kuten frame_rate_check_failed, ja SEND_TO_USER_INBOX merkitsee luonnoksen. post_ids saapuu, kun postaus on julkisesti katsottavissa, enintään kolme minuuttia PUBLISH_COMPLETE-tilan jälkeen, ja /business/video/list/ suodattaa näillä tunnuksilla postauksen mittarit.
Miten luet kommentit ja vastaat niihin?
Tilin omissa postauksissa video_id-tunnuksella, joka on /business/video/list/ -vastauksen item_id. GET /business/comment/list/ palauttaa julkiset ja piilotetut kommentit, enintään 30 sivulla, ja POST /business/comment/reply/create/ julkaisee julkisen vastauksen, enintään 1 200 merkkiä, raja, jonka TikTok nosti 150:stä 7. elokuuta 2026. Muut endpointit piilottavat kommentin tai näyttävät sen uudelleen ja poistavat tilin itse kirjoittamat kommentit.
Miten webhookit toimivat API for Business -rajapinnassa?
Sovelluskohtaisesti eikä tilikohtaisesti. POST /business/webhook/update/ -pyyntö, jossa on app_id, secret, event_type ja HTTPS-callback_url, tilaa sovelluksen: VIDEO tuo neljä julkaisutapahtumaa, ja COMMENT tuo comment.update-tapahtuman viiden minuutin sisällä muutoksesta. Jokainen toimitus allekirjoitetaan Tiktok-Signature-otsakkeessa HMAC-SHA256:lla, jonka avaimena on sovelluksen secret. Se vaatii heti HTTP 200 -vastauksen, ja sitä yritetään uudelleen enintään 72 tuntia, jos vastausta ei tule.
Mistä insightit saadaan?
Kahdesta endpointista. GET /business/get/ palauttaa profiilin ja päivittäiset tilimittarit, kuten followers_count, video_views, profile_views ja likes, enintään 60 päivää taaksepäin UTC-ajassa. GET /business/video/list/ palauttaa jokaisen postauksen elinikäiset luvut video_views- ja reach-mittareista average_time_watched-mittariin, enintään 20 postausta sivulla. Useimmat luvut saapuvat 24–48 tuntia myöhässä, ja jokainen kenttä vaatii oman scopensa tokenissa.
Mitkä rajat muovaavat integraatiota?
Neljä, joista kukin lasketaan erikseen:
- 40 kutsua minuutissa valtuutettua tiliä kohden kullakin Accounts API -endpointilla.
- 600 kutsua minuutissa sovelluksen Accounts API -kutsuille yhteensä Basic-tasolla ja 1 000 sen yläpuolella.
- Kuusi postausta minuutissa ja 15 päivässä tiliä kohden kullakin julkaisuendpointilla.
- Koodi 40100 HTTP 200 -vastauksen sisällä, kun TikTok rajoittaa kutsun: odota 5 minuuttia minuuttirajan jälkeen tai odota kello 00:00 UTC:hen asti päivärajan jälkeen.
Mikä on polku easyCoexistencen kautta?
Lyhyempi, koska easyCoexistence on hoitanut kehittäjäpuolen omalla API for Business -sovelluksellaan ja vahvistetulla mediareitillään. Henkilökohtainen tai Business-tili yhdistetään kirjautumalla TikTokiin, ja Claude, ChatGPT tai oma alustasi työskentelee sen kanssa yhden MCP-konnektorin tai Partner API:n kautta ilman omaa rekisteröintiä, sovelluksen tarkistusta tai tokenpalvelinta:
Yleiset virheet
- Sovelluksen lähettäminen ennen käyttölomaketta. 20. maaliskuuta 2026 alkaen TikTok vaatii Accounts API Access Application Form -lomakkeen ensin uudelle sovellukselle tai scope-pyynnölle, joka sisältää TikTok Accounts -oikeuden.
- Median tallentaminen domainilla, jota sovellus ei ole vahvistanut. TikTok lataa video_url- ja photo_images-kentät itse ja hylkää URL-osoitteet vahvistetun domainin tai URL-etuliitteen ulkopuolelta.
- Suunnittelu yhdelle tilille. Tokenit, business_id ja 40 kutsua minuutissa kuuluvat kullekin tilille, kun taas webhook-asetukset ja yhdistetty kutsubudjetti kuuluvat sovellukselle, joten mallinna molemmat tasot alusta asti.
- Vain nykyisen ominaisuuden tarvitsemien scopejen pyytäminen. Token säilyttää omistajan hyväksymät scopet, joten kommenttien tai insightien lisääminen myöhemmin tarkoittaa, että jokainen omistaja valtuuttaa sovelluksen uudelleen.
Tokenit uusitaan, ja jokainen tili tarkistetaan noin 6 tunnin välein, jotta Claude, ChatGPT tai oma alustasi voi julkaista, vastata kommentteihin ja lukea insightit TikTokissa yhden MCP-konnektorin tai Partner API:n kautta. Hinta on US$ 9:stä US$ 0,75:een yhteyttä kohden kuukaudessa ja laskee yhteyksien määrän kasvaessa, ja ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Tarvitsenko erillisen TikTok-kehittäjäsovelluksen jokaiselle asiakastilille?
Et. Yksi kehittäjäsovellus palvelee tilejä, jotka sen valtuuttavat, ja jokaisella tilillä on oma tokeninsa ja business_id. TikTok sallii enintään viisi sovellusta kehittäjää kohden.
Onko Accounts API sama kuin TikTokin Marketing API?
Ei. Molemmat kuuluvat API for Business -rajapintaan, mutta Marketing API ajaa mainoksia mainostajatokeneilla, jotka eivät vanhene, kun taas Accounts API käyttää TikTok-tilin tokeneita, jotka kestävät yhden päivän.
Mitä TikTok API -versiota uuden koodin pitäisi käyttää?
v1.3, joka on ollut saatavilla 15. elokuuta 2022 alkaen ilman päättymispäivää. v1.2 ei ole saanut päivityksiä 15. elokuuta 2023 jälkeen, ja TikTok tekee rikkovia muutoksia vain uusiin versioihin.
Mitä easyCoexistence maksaa per TikTok-tili?
US$ 9:stä US$ 0,75:een yhteyttä kohden kuukaudessa, määräytyen siitä hintaluokasta, johon yhteyksiesi kokonaismäärä kuuluu, ja ensimmäiset 3 päivää ovat ilmaisia. Jokainen TikTok-tili on yksi yhteys.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu