Jumlah pengikut dan info profil TikTok lewat API
API for Business TikTok mengembalikan jumlah pengikut akun sebagai followers_count dari GET /business/get/, bersama username, display_name, profile_image, bio_description, is_verified, following_count, total_likes, dan videos_count, yang masing-masing memerlukan scope seperti user.info.stats. /v2/user/info/ milik Display API mengembalikan jumlah yang sama sebagai follower_count untuk pengguna yang telah mengotorisasi aplikasi.
easyCoexistence membaca profil dan jumlah pengikut akun TikTok dengan get_social_insights dari Claude, ChatGPT, atau kode Anda sendiri: sebutkan field seperti followers_count, total_likes, atau videos_count, dengan tanggal untuk baris harian, dan hasilnya adalah angka TikTok apa adanya.
Scope yang dibutuhkan untuk followers_count, following_count, total_likes, dan videos_count ada di bagian atas /business/get/.
Cara TikTok memperbarui followers_count dan field profil, sementara metrik harian biasanya tiba 24 hingga 48 jam kemudian.
Nama Display API untuk jumlah tersebut di /v2/user/info/, di bawah scope user.info.stats-nya sendiri.
Rentang terlama ke belakang untuk followers_count harian dan metrik harian lain di /business/get/.
Yang dikembalikan /business/get/ saat permintaan tidak menyebut field apa pun: display_name dan profile_image.
Field profil apa saja yang dikembalikan /business/get/?
Field yang disebut dalam fields, berupa array JSON di query string, yang masing-masing dibuka oleh scope yang diberikan pemilik akun saat mengotorisasi aplikasi. Permintaan yang tidak menyebut field apa pun hanya mendapat display_name dan profile_image. TikTok memperbarui field profil dan jumlah di bawah ini secara waktu nyata:
Bagaimana cara meminta jumlah pengikut?
Dengan GET ke /business/get/, token akun di header Access-Token, business_id-nya (open_id dari pertukaran token), serta field yang diinginkan. Jumlah saat ini berada di bagian atas data, dan angka tiap hari di metrics:
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 }
]
}
}Bagaimana melacak pengikut hari demi hari?
Sebutkan followers_count di fields, dan TikTok mengembalikannya dua kali: total seumur hidup di bagian atas data, di bawah user.info.stats, dan total pada tiap hari di dalam metrics, di bawah user.insights. start_date dan end_date, dalam UTC, memilih harinya, hingga 60 hari ke belakang; tanpa keduanya, TikTok mengembalikan 7 hari hingga sehari sebelum permintaan. Tiga field harian menunjukkan pergerakan di balik total, untuk akun dengan Advanced Access atau Verified Business Account:
daily_new_followers: pengikut yang bertambah pada hari itu.daily_lost_followers: pengikut yang hilang pada hari itu.daily_total_followers: pertumbuhan bersih hari itu, yaitu penambahan dikurangi kehilangan.
Apa yang dikembalikan Display API?
Profil serupa untuk pengguna yang telah mengotorisasi aplikasi TikTok for Developers, dari GET https://open.tiktokapis.com/v2/user/info/ dengan field yang tercantum di parameter fields. Nama dan scope-nya berbeda dari API for Business, dan objek user-nya tidak menyimpan riwayat harian:
| 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 |
Bisakah membaca jumlah pengikut akun lain?
Tidak dengan kedua endpoint ini. /business/get/ menjawab untuk business_id dari akun yang telah mengotorisasi aplikasi, dan /v2/user/info/ untuk pengguna yang tokennya dipakai untuk permintaan. Research API TikTok memiliki endpoint /v2/research/user/info/ yang menerima username dan mengembalikan follower_count, following_count, likes_count, dan video_count, tetapi hanya untuk peneliti yang disetujui TikTok.
Bagaimana easyCoexistence membaca profil?
Dengan get_social_insights pada akun, tanpa object_id: nama di metrics menjadi field /business/get/, start_date dan end_date di params memilih harinya, dan hasilnya adalah data TikTok apa adanya. Daftar metrics yang kosong meminta username, nama tampilan, foto, jumlah pengikut, following, like, dan video, dua flag tingkat akun, serta views video harian, views profil, dan pengikut baru. list_social_accounts juga menampilkan username dan nama tampilan yang tersimpan saat akun terhubung.
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" }
}Kesalahan umum
- Meminta followers_count tanpa user.info.stats pada token. TikTok hanya mengembalikan tiap field jika pemilik telah memberikan scope-nya, sehingga pemilik harus mengotorisasi aplikasi lagi.
- Menyimpan profile_image untuk nanti. Itu adalah URL sementara yang masa berlakunya ada di parameter x-expires-nya, jadi ambil yang baru saat dibutuhkan.
- Membaca follower_count dari /business/get/. Itu nama di Display API; API for Business menyebutnya followers_count.
- Mengharapkan pengikut baru dan hilang pada akun pribadi. TikTok mengembalikan field harian itu hanya untuk Advanced Access atau Verified Business Account.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Bisakah TikTok API menampilkan pertumbuhan pengikut dari waktu ke waktu?
Bisa, hingga 60 hari: followers_count untuk tiap hari di metrics, ditambah pengikut baru, hilang, dan bersih harian pada Advanced Access atau Verified Business Account.
Scope apa yang dibutuhkan jumlah pengikut TikTok?
user.info.stats, di kedua API: scope ini membuka followers_count di /business/get/ dan follower_count di /v2/user/info/ milik Display API.
Apakah akun TikTok pribadi mengembalikan jumlah pengikutnya?
Ya. followers_count bergantung pada scope, bukan tingkat akun; hanya sebagian field harian yang memerlukan Advanced Access atau Verified Business Account.
Seberapa sering jumlah pengikut TikTok diperbarui?
TikTok menandai followers_count tingkat atas sebagai waktu nyata, sementara baris harian di metrics biasanya tiba 24 hingga 48 jam terlambat, dalam UTC.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada