TikTok-seuraajamäärä ja profiilitiedot API:n kautta
TikTok API for Business palauttaa tilin seuraajamäärän kentässä followers_count pyynnöstä GET /business/get/. Sen lisäksi saat username-, display_name-, profile_image-, bio_description-, is_verified-, following_count-, total_likes- ja videos_count-kentät, joista jokainen vaatii scopen, kuten user.info.stats. Display API:n /v2/user/info/ palauttaa saman määrän nimellä follower_count käyttäjälle, joka on valtuuttanut sovelluksen.
easyCoexistence lukee TikTok-tilin profiilin ja seuraajamäärän get_social_insights-työkalulla Claudesta, ChatGPT:stä tai omasta koodistasi: nimeä kentät, kuten followers_count, total_likes tai videos_count, ja päivittäisille riveille päivämäärät.
Scope, joka vaaditaan followers_count-, following_count-, total_likes- ja videos_count-kentille /business/get/-ohjeen alussa.
Miten TikTok päivittää followers_count- ja profiilikentät, kun päivittäiset mittarit saapuvat yleensä 24–48 tunnin viiveellä.
Display API:n nimi seuraajamäärälle /v2/user/info/-pyynnössä, omalla user.info.stats-scopellaan.
Pisin takautuva ajanjakso päivittäisille followers_count- ja muille päivittäisille mittareille /business/get/-pyynnössä.
Mitä /business/get/ palauttaa, kun pyyntö ei nimeä kenttiä: display_name ja profile_image.
Mitkä profiilikentät /business/get/ palauttaa?
Ne, jotka nimeät fields-kentässä JSON-taulukkona kyselymerkkijonossa. Jokaisen avaa scope, jonka tilin omistaja on myöntänyt sovellusta valtuuttaessaan. Pyyntö, joka ei nimeä kenttiä, saa vain display_name- ja profile_image-kentät. TikTok päivittää seuraavat profiili- ja laskurikentät reaaliajassa:
Miten seuraajamäärän pyydät?
GET-pyynnöllä osoitteeseen /business/get/. Mukana ovat tilin token Access-Token-otsakkeessa, business_id eli token-vaihdosta saatu open_id sekä haluamasi kentät. Ajankohtaiset luvut ovat data-kohdan alussa ja päivittäiset luvut metrics-kohdassa:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["display_name","followers_count","following_count","is_verified","daily_new_followers","daily_lost_followers"]'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"display_name": "<DISPLAY_NAME>",
"followers_count": 13,
"following_count": 2,
"is_verified": false,
"metrics": [
{ "date": "<DATE>", "followers_count": 13, "daily_new_followers": 0, "daily_lost_followers": 0 }
]
}
}Miten seuraat seuraajia päivä päivältä?
Kun nimeät followers_count-kentän fields-kentässä, TikTok palauttaa sen kahdesti: kokonaismäärän data-kohdan alussa, scopella user.info.stats, ja päivittäisen määrän metrics-kohdan sisällä, scopella user.insights. start_date ja end_date UTC-ajassa valitsevat päivät, enintään 60 päivää taaksepäin. Ilman niitä TikTok palauttaa 7 päivää pyyntöä edeltävään päivään asti. Kolme päivittäistä kenttää näyttävät kokonaismäärän takana olevan muutoksen tileille, joilla on Advanced Access tai Verified Business Account:
daily_new_followers: sinä päivänä saadut seuraajat.daily_lost_followers: sinä päivänä menetetyt seuraajat.daily_total_followers: päivän nettokasvu, lisäykset miinus menetykset.
Mitä Display API palauttaa?
Saman tyyppisen profiilin käyttäjälle, joka on valtuuttanut TikTok for Developers -sovelluksen, osoitteesta GET https://open.tiktokapis.com/v2/user/info/, ja kentät luetellaan fields-parametrissa. Nimet ja scopet eroavat API for Business -rajapinnasta, eikä sen user-objektissa ole päivittäistä historiaa:
| API for Business: /business/get/ | Display API: /v2/user/info/ | |
|---|---|---|
| Followers | followers_count | follower_count |
| Following | following_count | following_count |
| Likes | total_likes | likes_count |
| Videos | videos_count | video_count |
| Count scope | user.info.stats | user.info.stats |
| Username scope | user.info.username | user.info.profile |
| Photo | profile_image | avatar_url, avatar_url_100, avatar_large_url |
| Daily history | Up to 60 days in metrics | Not in the user object |
Voiko toisen tilin seuraajamäärän lukea?
Ei näillä kahdella päätepisteellä. /business/get/ vastaa sovelluksen valtuuttaneen tilin business_id:lle ja /v2/user/info/ sille käyttäjälle, jonka token kutsun tekee. TikTokin Research API:ssa on /v2/research/user/info/-päätepiste, joka ottaa käyttäjänimen ja palauttaa follower_count-, following_count-, likes_count- ja video_count-kentät, mutta vain TikTokin hyväksymille tutkijoille.
Miten easyCoexistence lukee profiilin?
get_social_insights-työkalulla tilille ilman object_id-kenttää: metrics-kohdan nimet muuttuvat /business/get/-kentiksi, params-kohdan start_date ja end_date valitsevat päivät, ja tulos on TikTokin data sellaisenaan. Tyhjä metrics-lista pyytää käyttäjänimen, näyttönimen, kuvan, seuraajamäärän, seurattavien määrän, tykkäysmäärän ja videomäärän, kaksi tilitason lippua sekä päivittäiset videonäytöt, profiilinäytöt ja uudet seuraajat. list_social_accounts näyttää myös käyttäjänimen ja näyttönimen, jotka tallentuivat, kun tili yhdistettiin.
get_social_insights {
"account_id": "<ACCOUNT_ID>",
"metrics": ["followers_count", "following_count", "total_likes", "videos_count"],
"params": { "start_date": "2026-10-02", "end_date": "2026-10-31" }
}Yleiset virheet
- Seuraajamäärän pyytäminen tokenilla, jolla ei ole user.info.stats-scopea. TikTok palauttaa kentän vain, jos omistaja on myöntänyt sen scopen, joten omistajan täytyy valtuuttaa sovellus uudelleen.
- Profiilikuvan (profile_image) tallentaminen myöhempää käyttöä varten. Se on väliaikainen URL, jonka vanhenemisaika on x-expires-parametrissa, joten hae tuore kuva silloin, kun sitä tarvitaan.
- follower_count-kentän lukeminen /business/get/-pyynnöstä. Se on Display API:n nimi; API for Business kutsuu sitä followers_count-kentäksi.
- Uusien ja menetettyjen seuraajien odottaminen henkilötilillä. TikTok palauttaa nuo päivittäiset kentät vain Advanced Access- tai Verified Business Account -tileille.
Se palauttaa TikTokin luvut sellaisinaan. US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, hinta laskee yhteyksiä lisättäessä, ensimmäiset 3 päivää ilmaiseksi.
Usein kysytyt kysymykset
Voiko TikTok API näyttää seuraajakasvun ajan yli?
Kyllä, enintään 60 päivältä: followers_count jokaiselta päivältä metrics-kohdassa sekä päivittäiset uudet, menetetyt ja nettoseuraajat tileillä, joilla on Advanced Access tai Verified Business Account.
Mikä scope TikTokin seuraajamäärään tarvitaan?
user.info.stats molemmissa rajapinnoissa: se avaa followers_count-kentän /business/get/-pyynnössä ja follower_count-kentän Display API:n /v2/user/info/-pyynnössä.
Palauttaako henkilökohtainen TikTok-tili seuraajamäärän?
Kyllä. followers_count riippuu scopesta, ei tilitasosta; vain osa päivittäisistä kentistä vaatii Advanced Accessin tai Verified Business Account -tilin.
Kuinka usein TikTokin seuraajamäärä päivittyy?
TikTok merkitsee päätason followers_count-kentän reaaliaikaiseksi, kun taas metrics-kohdan päivittäiset rivit saapuvat yleensä 24–48 tuntia myöhässä, UTC-ajassa.
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