מגבלות קצב של TikTok API: קריאות לכל חשבון, אפליקציה ונקודת קצה
ממשק TikTok API for Business מגביל קריאות בשלוש רמות בבת אחת: 40 קריאות לדקה לכל חשבון מורשה בכל נקודת קצה של Accounts API, מכסה משותפת לנקודות Accounts API באפליקציית מפתחים: 600 לדקה ב-Basic ו-1,000 מעליה, ומגבלות לכל נקודת קצה לאפליקציה: 10 לשנייה, 600 לדקה ו-864,000 ליום ב-Basic, ועולות ל-50 לשנייה ב-Ultimate, שהיא הרמה הגבוהה.
easyCoexistence מפרסם פוסטים, קורא תובנות ומשיב לתגובות ב-TikTok עבור Claude, ChatGPT או הקוד שלכם, דרך ממשק TikTok API for Business.
קריאות לדקה לכל חשבון TikTok מורשה בכל נקודת קצה של Accounts API, מספר יחיד שאינו תלוי ברמת האפליקציה.
מכסה לכל נקודות Accounts API יחד באפליקציית מפתחים ברמות Advanced, Premium ו-Ultimate; ב-Basic המכסה היא 600.
מגבלה לכל נקודת קצה ברמת Ultimate, הרמה העליונה של האפליקציה, לצד 3,000 קריאות לדקה ו-4,320,000 ביום.
סטטוס ש-TikTok מחזיר יחד עם קודי החזרה שלו, כולל קודים מסוג 4xxxx כמו 40100; רק קוד 0 מציין הצלחה.
מגבלת קצב לכל נקודת קצה של Discovery API לכל אפליקציית מפתחים.
מתי המכסות היומיות מתאפסות; לאחר מגבלה לדקה, TikTok מבקש השהיה של 5 דקות במקום זאת.
אילו מגבלות חלות על קריאה?
עם כל קריאה ל-Accounts API מתעדכנים עד שלושה מונים, ולחלק מהמוצרים והפעולות יש מונים משלהם. TikTok שומר את מוני נקודות הקצה עצמאיים זה מזה, כך שנקודת קצה אחת עשויה להיחסם בעוד שאר נקודות האפליקציה ממשיכות להשיב:
מה ארבע רמות האפליקציה מאפשרות?
כל אפליקציות המפתחים מתחילות ב-Basic, ו-TikTok מעלה אפליקציה רמה אחת בכל פעם כשמבקשים זאת תחת My Apps, App Detail, Authorization, עם נימוק. כל רמה קובעת כמה יכולה לקבל נקודת קצה אחת מהאפליקציה, והמכסה המשותפת לקריאות Accounts API מופיעה לצידן:
האם רמה גבוהה יותר מרחיבה את המכסה המשותפת?
פעם אחת. המעבר מ-Basic ל-Advanced מעלה את המכסה המשותפת מ-600 ל-1,000 קריאות לדקה, והיא נשארת על 1,000 גם ב-Premium וב-Ultimate, בעוד שהמגבלות לנקודת קצה לשנייה וליום ממשיכות לעלות. המגבלה של 40 לדקה לכל חשבון ולכל נקודת קצה אינה משתנה כלל עם הרמה, ולכן חשבון עמוס מאוד ייחסם ב-40 קריאות לדקה בנקודת קצה מסוימת, בכל רמה שהאפליקציה מחזיקה בה.
איך המגבלות מצטברות על פני חשבונות רבים?
המגבלה לחשבון מוכפלת עם כל חשבון; מכסת האפליקציה אינה מוכפלת. עשרה חשבונות יכולים לבצע כל אחד 40 קריאות לדקה אל /business/comment/list/, כלומר 400 בסך הכול, אבל עשרים שעושים את אותו הדבר יזדקקו ל-800, מעל ה-600 שיש לאפליקציית Basic לקריאות Accounts API יחד, עוד לפני שנספרת נקודת קצה אחרת. מעל Basic, המכסה המשותפת הזו מגיעה לשיא של 1,000 לדקה.
מה קורה כשקריאה עוברת מגבלה?
TikTok חוסם את נקודת הקצה הזו. מדריך המגבלות שלו מציין את קוד 40100 לקריאה חסומה, שמגיע בגוף של תשובת HTTP 200, ונקודת הקצה נשארת סגורה 5 דקות אחרי מגבלה לדקה, או עד שהמונים היומיים מתאפסים בשעה 00:00 UTC אחרי מגבלה יומית, בעוד שנקודות הקצה האחרות של האפליקציה ממשיכות להשיב. זיהוי הקוד בגוף התשובה והניסיון החוזר הנכון שייכים לטיפול בשגיאה 40100 עצמה.
האם מגבלות הפרסום הן מגבלות קצב?
לא, הן סופרות פוסטים ולא קריאות, ויש להן דף משלהן. TikTok מאפשר לחשבון לפרסם שישה פוסטים לדקה ו-15 ביום דרך /business/video/publish/, וכך גם דרך /business/photo/publish/. פוסט מעבר למספר הזה נכשל עם spam_risk_too_many_posts בסטטוס הפרסום שלו, בעוד שמגבלת בקשות דוחה את הקריאה עצמה.
אילו הרגלים מכלים את המגבלות הכי מהר?
בדיקות חוזרות (polling). בדיקת סטטוס פרסום או רשימת תגובות על טיימר מכלה את 40 הקריאות לדקה של החשבון באותה נקודת קצה, בין אם משהו השתנה ובין אם לא, ו-TikTok מציע וובהוקים (Webhook) שנועדו להחליף את זה: אירועי פרסום פוסטים מדווחים על כל שלב בפוסט, ו-comment.update מדווח על תגובה חדשה תוך חמש דקות. קריאה בעמודים, 20 פוסטים או 30 תגובות בכל קריאה, ומשיכת אזכורים פעם ביום, שומרות על השאר נמוך.
איך easyCoexistence מטפל בקריאה ל-TikTok שנחסמה?
הוא מעביר הלאה את התשובה של TikTok ולא מסתיר אותה. קריאת כלי ש-TikTok חוסם, כמו list_social_comments, reply_to_comment או get_tiktok_publish_status, מגיעה ל-AI כשגיאה שמכילה את הקוד 40100 ואת ההודעה של TikTok, ואינה נשלחת שוב מעצמה. פוסטים עוברים דרך אחרת, שכן publish_tiktok_post מעביר כל פוסט לתור של easyCoexistence, עכשיו או בזמן שנקבע:
- כשמתקבל קוד HTTP 429 בתשובה, התור ממתין ומנסה שוב אחרי 5 דקות, 30 דקות ושעתיים.
- TikTok שולח 40100 בתוך תשובת HTTP 200, ולכן פרסום שנחסם ב-TikTok נכשל עם ההודעה של TikTok ומחכה תחת "Needs attention" עד ללחיצה על "Retry" לניסיון חוזר.
- קוד 40100 בבדיקת סטטוס מהתור מכשיל גם את הפוסט, אף ש-TikTok עשוי כבר לפרסם אותו, ולכן בדקו את הפוסטים האחרונים של החשבון לפני ניסיון חוזר.
- פוסט שנכשל ברקע שולח מייל לבעלים, לכל היותר פעם ב-3 שעות לכל ערוץ.
אילו קריאות ל-TikTok מבצע easyCoexistence עבור חשבון?
כמה מעטות, והן נספרות מול המגבלות של החשבון בדיוק כמו הקריאות שלכם:
- /business/get/ בערך כל 6 שעות, כדי לוודא שהחשבון עדיין משיב.
- קריאת פרסום אחת לכל פוסט, ואחריה /business/publish/status/ בערך כל 20 שניות עד ש-TikTok משלים או נכשל את הפוסט, עד שעתיים.
- כשכללי תגובות או אוטומציות פעילים, נקודת הקצה /business/comment/list/ נקראת פעם אחת לכל תגובה חדשה ברמה העליונה, כדי לקרוא את המחבר שלה, וקריאה נוספת לכל תגובה שנשלחה כמענה.
- קריאות כלים רק כשה-AI או הקוד שלכם מבקשים, כשכל קריאה מחזירה 20 פוסטים או 30 תגובות.
טעויות נפוצות
- זיהוי חסימה לפי סטטוס ה-HTTP. TikTok עונה 40100 עם HTTP 200, ולכן בדיקה של res.ok או של 429 מפספסת אותו; יש לקרוא את הקוד מגוף התשובה.
- העלאת הרמה של האפליקציה כדי לתקן חשבון עמוס אחד. 40 הקריאות לדקה לכל חשבון ולכל נקודת קצה נשארות זהות בכל ארבע הרמות, ולכן יש לפזר את הקריאות של אותו חשבון לאורך הזמן.
- משיכת נתוני Mentions פעמים רבות ביום. TikTok מרענן אותם פעם אחת, בין חצות ל-7 בבוקר לפי UTC, ומומלץ קריאה אחת לכל נקודת קצה ולכל חשבון ביום.
הוא מחזיר את הקוד וההודעה של TikTok כשקריאה נחסמת, ועוקב אחרי כל פוסט עד ש-TikTok משלים אותו או נכשל. US$ 9 עד US$ 0.75 לחיבור בחודש, וככל שמוסיפים חיבורים המחיר יורד, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
מהי מגבלת הקצב לכל חשבון?
40 קריאות לדקה בכל נקודת קצה של Accounts API לכל חשבון TikTok מורשה, בתוך המכסה המשותפת של אפליקציית המפתחים: 600 לדקה ב-Basic או 1,000 מעליה.
האם מגבלות הקצב נספרות לפי נקודת קצה?
כן. מדריך המגבלות של TikTok קובע שהמגבלות לכל נקודת קצה עצמאיות, ולכן הגעה למגבלה של נקודה אחת אינה עוצרת קריאות לנקודה אחרת.
איך מעלים את מגבלת הקצב?
מגישים בקשה תחת My Apps, App Detail, Authorization ומציינים נימוק. הרמות עולות צעד אחד בכל פעם, מ-Basic ל-Advanced, אחר כך Premium, ורק אז Ultimate, הרמה העליונה.
האם קריאות שעוברות דרך easyCoexistence נספרות במגבלות?
כן. הן רצות בשם החשבון המחובר עם האסימון שלו, ולכן נספרות במכסה של 40 קריאות לדקה לכל נקודת קצה כמו כל קריאה אחרת של אותו חשבון.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-