TikTok analytics API: תובנות חשבון ומדדי סרטונים
ה-API for Business של TikTok מחזיר מדדי חשבון לפי יום, כמו עוקבים, צפיות בסרטונים, צפיות בפרופיל, לייקים, תגובות ושיתופים, עד 60 הימים האחרונים. כל סרטון מחזיר את הספירות המצטברות שלו: צפיות, לייקים, תגובות ושיתופים. רוב הספירות מגיעות באיחור של 24 עד 48 שעות, והן תלויות בכך ש-TikTok Analytics פעיל באפליקציה.
easyCoexistence קורא תובנות TikTok בעזרת get_social_insights מתוך Claude, ChatGPT או הקוד שלכם: עוקבי החשבון, הצפיות והלייקים לפי יום, או הצפיות, הלייקים, התגובות והשיתופים של סרטון.
הטווח הארוך ביותר למדדים היומיים של חשבון. ללא תאריכים, ה-API מחזיר את 7 הימים האחרונים.
העיכוב הרגיל עד שמדדים יומיים וספירות לכל פוסט, כמו לייקים, צפיות ושיתופים, זמינים.
הזמן מרגע הפרסום שבו הנתונים של פוסט מפסיקים להתעדכן.
מספר העוקבים שחשבון צריך כדי ש-TikTok יחזיר פירוט של גיל, מגדר ומיקום העוקבים.
אילו מדדי חשבון יש?
GET /business/get/ מחזיר את פרופיל החשבון וגם, לתאריכים שנבקשו, רשימת מדדים עם שורה אחת לכל יום, לפי UTC:
followers_count: הסך הכולל כעת, והסך הכולל בכל יום.video_views,profile_views, likes, comments, shares: ספירות יומיות על פני הסרטונים של החשבון.unique_video_views,daily_new_followers,daily_lost_followers,engaged_audience: יומיים, לחשבונות עם Advanced Access או Verified Business Accounts.audience_ages,audience_genders,audience_countries,audience_cities: פירוט עוקבים, לחשבונות עם 100 עוקבים לפחות.
אילו מדדי סרטונים יש?
GET /business/video/list/ מחזיר את הפוסטים הציבוריים של החשבון עם ספירות לכל החיים, בלי ההגבלה של 60 הימים: video_views, likes, comments, shares, favorites, וכן הגעה, זמן צפייה כולל וממוצע, שיעור צפייה מלאה, עוקבים חדשים ומקורות תנועה. מוחזרים עד 20 פוסטים בעמוד, והשדה filters.video_ids מאפשר לבחור סרטונים מסוימים.
כמה טריים הנתונים?
שדות פרופיל, כמו שם המשתמש ומספר העוקבים הנוכחי, הם בזמן אמת. מדדים יומיים של החשבון וספירות פוסט, כמו צפיות, לייקים, תגובות ושיתופים, בדרך כלל מתעכבים 24 עד 48 שעות, לפי UTC, ונתוני פוסט מפסיקים להתעדכן 365 ימים אחרי פרסומו. הגעה, זמן צפייה ומקורות תנועה יכולים להיות חסרים לסרטון שלא נצפה, לא קיבל לייק, תגובה או שיתוף במשך יותר מ-7 ימים.
למה מדדים יכולים להיות חסרים?
ה-API מחזיר מה ש-TikTok Analytics מכיל. בעל החשבון צריך לפרסם לפחות סרטון אחד ולהפעיל את Analytics באפליקציית TikTok, ונתונים מלפני ההפעלה אינם זמינים. חלק מהמדדים דורשים יותר: ההגעה והעוקבים החדשים והעוקבים שאבדו זמינים רק לחשבונות עם Advanced Access או Verified Business Accounts, ופירוט העוקבים מתחיל מ-100 עוקבים.
למה הספירות יכולות להיות שונות מאפליקציית TikTok?
בגלל מה שהן כוללות. השדה video_views סופר צפיות אורגניות ומשולמות יחד, וספירת השיתופים כוללת גם שיתופים מחוץ ל-TikTok וגם שליחות לחברים באפליקציה, ולכן היא עשויה להיות גבוהה יותר מספירת השיתופים באתר TikTok. הנתון היומי של לייקים אינו מחסיר לייקים שהוסרו מאוחר יותר.
איך easyCoexistence קורא אותם?
בעזרת get_social_insights. לחשבון, מבקשים מדדים כמו followers_count, video_views או likes, יחד עם start_date וגם end_date, והתוצאה היא השורות היומיות של TikTok. לסרטון יחיד, מעבירים את item_id בתור object_id, והוא מחזיר צפיות, לייקים, תגובות ושיתופים, ומחפש בין 20 הסרטונים האחרונים של החשבון. לסרטון ישן יותר, הקוד שלכם שולח בקשה אל business/video/list/ עם filters.video_ids, עם האסימון מ-get_social_credentials.
טעויות נפוצות
- להתייחס למספרי אתמול כסופיים. מדדים יומיים יכולים להתעכב 24 עד 48 שעות, ולכן הימים האחרונים עדיין עשויים להתמלא.
- לבקש יותר מ-60 ימים של מדדי חשבון. ההגבלה נעצרת שם, לכן שמרו את המספרים אם אתם צריכים היסטוריה ארוכה יותר.
- לחפש סרטון ישן לפי object_id. get_social_insights מחפש בין 20 הסרטונים האחרונים; לפוסטים ישנים, סננו באמצעות השדה video_ids מהקוד שלכם, עם האסימון מ-get_social_credentials.
- להשוות את ספירת השיתופים ב-API לזו שבאתר. ה-API סופר גם שליחות לחברים בתוך TikTok, ולכן המספר שלו גבוה יותר.
לשדות תובנות אחרים של TikTok, get_social_credentials נותן לקוד שלכם את האסימון של החשבון. מ-US$ 9 עד US$ 0.75 לכל חיבור בחודש, והמחיר יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
האם ה-API של TikTok מראה כמה עוקבים חשבון איבד?
כן. הנתון נקרא daily_lost_followers, ולצידו daily_new_followers, לחשבונות עם Advanced Access או Verified Business Accounts.
כמה רחוק אחורה מגיעות תובנות החשבון של TikTok?
60 ימים. בלי תאריכים, ה-API מחזיר את 7 הימים שעד יום לפני הבקשה, לפי UTC.
מתי נתוני סרטון ב-TikTok מפסיקים להתעדכן?
365 ימים אחרי פרסומו. עד אז הספירות המצטברות ממשיכות להתעדכן, בדרך כלל עם עיכוב של 24 עד 48 שעות.
האם צפיות בסרטוני TikTok כוללות צפיות משולמות?
כן. הנתון video_views שמחזיר TikTok כולל צפיות אורגניות ומשולמות יחד.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-