קבלת מספר העוקבים ופרטי הפרופיל של TikTok דרך ה-API
ממשק API for Business של TikTok מחזיר את מספר העוקבים של חשבון בשדה followers_count, מ-GET /business/get/. לצדו מוחזרים username, display_name, profile_image, bio_description, is_verified, following_count, total_likes וגם videos_count, ולכל אחד נדרשת הרשאה, כמו user.info.stats. ה-Display API, דרך /v2/user/info/, מחזיר את אותו מספר בשדה follower_count למשתמש שאישר את האפליקציה.
easyCoexistence קורא את הפרופיל ואת מספר העוקבים של חשבון TikTok בעזרת get_social_insights מתוך Claude, ChatGPT או מהקוד שלכם: מציינים שדות כמו followers_count, total_likes או videos_count, ועם תאריכים לשורות יומיות, והתוצאה היא הנתונים של TikTok כפי שהם.
ההרשאה שנדרשת עבור followers_count, following_count, total_likes וגם videos_count מופיעה בראש /business/get/.
איך TikTok מעדכן את followers_count ואת שדות הפרופיל, ואילו מדדים יומיים מגיעים בדרך כלל באיחור של 24 עד 48 שעות.
השם שבו Display API מחזיר את המספר ב-/v2/user/info/, תחת ההרשאה user.info.stats שלו.
החלון הארוך ביותר לאחור ב-/business/get/ עבור followers_count היומי ושאר המדדים היומיים.
כשהבקשה ל-/business/get/ לא מציינת שדות, מוחזרים display_name וגם profile_image, ואין עוד.
מה /business/get/ מחזיר מבחינת שדות פרופיל?
אלה השדות שמצוינים בפרמטר fields, מערך JSON במחרוזת השאילתה, וכל אחד מהם נפתח בהרשאה שבעל החשבון העניק בעת אישור האפליקציה. בקשה שלא מציינת שדות מקבלת display_name וגם profile_image בלבד. TikTok מעדכן את שדות הפרופיל והספירות שלהלן בזמן אמת:
איך מבקשים את מספר העוקבים?
עם GET ל-/business/get/, אסימון הגישה של החשבון בכותרת Access-Token, עם business_id שהוא open_id מהחלפת האסימון, וגם השדות הרצויים. הספירות הנוכחיות נמצאות בראש data, ונתוני כל יום בשדה 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 }
]
}
}איך עוקבים אחרי העוקבים יום אחר יום?
כששולחים followers_count בפרמטר fields, TikTok מחזיר אותו פעמיים: הסך המצטבר בראש data, תחת user.info.stats, והסך של כל יום בתוך metrics, תחת user.insights. start_date וגם end_date, ב-UTC, קובעים את הימים, עד 60 ימים אחורה; בלעדיהם TikTok מחזיר את 7 הימים עד היום שלפני הבקשה. שלושה שדות יומיים מראים את התנועה מאחורי הסך, לחשבונות עם Advanced Access או Verified Business Account:
daily_new_followers: העוקבים שנוספו באותו יום.daily_lost_followers: העוקבים שאבדו באותו יום.daily_total_followers: הצמיחה נטו של היום, ההפרש בין הנוספים לאבודים.
מה ה-Display API מחזיר?
אותו סוג פרופיל למשתמש שאישר אפליקציה של TikTok for Developers, מ-GET https://open.tiktokapis.com/v2/user/info/ עם השדות שברשימה בפרמטר fields. השמות וההרשאות שונים מ-API for Business, ואובייקט user שלו לא כולל היסטוריה יומית:
| 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 |
אפשר לקרוא את מספר העוקבים של חשבון אחר?
לא עם שתי נקודות הקצה האלה. /business/get/ עונה לחשבון שאישר את האפליקציה, לפי business_id שלו, ו-/v2/user/info/ עונה למשתמש שהאסימון שלו מבצע את הקריאה. ל-Research API של TikTok יש נקודת קצה בשם /v2/research/user/info/ שמקבלת username ומחזירה follower_count, following_count, likes_count וגם video_count, אבל רק לחוקרים ש-TikTok אישר.
איך easyCoexistence קורא את הפרופיל?
עם get_social_insights על החשבון, בלי object_id: השמות בפרמטר metrics הופכים לשדות של /business/get/, הפרמטרים start_date וגם end_date בפרמטר params קובעים את הימים, והתוצאה היא הנתונים של TikTok כפי שהם. רשימת metrics ריקה מבקשת שם משתמש, שם תצוגה, תמונה, מספרי עוקבים, נעקבים, לייקים וסרטונים, שני הדגלים ברמת החשבון, וגם צפיות יומיות בסרטונים, צפיות בפרופיל ועוקבים חדשים. list_social_accounts מציג גם את שם המשתמש ושם התצוגה שנשמרו כשהחשבון חובר.
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" }
}טעויות נפוצות
- בקשת followers_count בלי user.info.stats באסימון. TikTok מחזיר כל שדה רק אם בעל החשבון העניק את ההרשאה שלו, ולכן בעל החשבון צריך לאשר את האפליקציה מחדש.
- שמירת profile_image לשימוש מאוחר יותר. זו כתובת זמנית, ותוקפה נמצא בפרמטר x-expires שלה, ולכן שולפים כתובת חדשה כשצריך אותה.
- קריאת follower_count מ-/business/get/. זה השם של Display API. ב-API for Business השדה נקרא followers_count, ולא אחרת.
- ציפייה לעוקבים חדשים ולעוקבים שאבדו בחשבון אישי. TikTok מחזיר את השדות היומיים האלה רק לחשבונות עם Advanced Access או עם Verified Business Account, ולא לחשבון אישי רגיל.
בין US$ 9 ל-US$ 0.75 לחיבור בחודש, והמחיר יורד ככל שמוסיפים חיבורים, כולל תקופת ניסיון של 3 ימים.
שאלות נפוצות
האם ה-TikTok API יכול להראות צמיחת עוקבים לאורך זמן?
כן, עד 60 ימים. יש followers_count לכל יום בשדה metrics, ובחשבונות עם Advanced Access או Verified Business Account גם עוקבים חדשים, שאבדו ונטו ליום.
איזו הרשאה נדרשת לספירת העוקבים ב-TikTok?
ההרשאה user.info.stats, בשני הממשקים: היא פותחת את followers_count ב-/business/get/ וגם את follower_count ב-/v2/user/info/ של Display API, והיא נדרשת בשני המקרים.
האם חשבון TikTok אישי מחזיר את מספר העוקבים שלו?
כן. followers_count תלוי בהרשאה ולא ברמת החשבון, ורק חלק מהשדות היומיים דורשים Advanced Access או Verified Business Account, ולא יותר מזה.
באיזו תדירות מתעדכן מספר העוקבים ב-TikTok?
TikTok מסמן את followers_count העליון כזמן אמת, אבל השורות היומיות בשדה metrics, לפי UTC, מגיעות בדרך כלל באיחור של 24 עד 48 שעות.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-