התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

מגבלות קצב של 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.

40 QPM

קריאות לדקה לכל חשבון TikTok מורשה בכל נקודת קצה של Accounts API, מספר יחיד שאינו תלוי ברמת האפליקציה.

1,000 QPM

מכסה לכל נקודות Accounts API יחד באפליקציית מפתחים ברמות Advanced, Premium ו-Ultimate; ב-Basic המכסה היא 600.

50 QPS

מגבלה לכל נקודת קצה ברמת Ultimate, הרמה העליונה של האפליקציה, לצד 3,000 קריאות לדקה ו-4,320,000 ביום.

HTTP 200

סטטוס ש-TikTok מחזיר יחד עם קודי החזרה שלו, כולל קודים מסוג 4xxxx כמו 40100; רק קוד 0 מציין הצלחה.

10 QPS

מגבלת קצב לכל נקודת קצה של Discovery API לכל אפליקציית מפתחים.

00:00 UTC

מתי המכסות היומיות מתאפסות; לאחר מגבלה לדקה, TikTok מבקש השהיה של 5 דקות במקום זאת.

אילו מגבלות חלות על קריאה?

עם כל קריאה ל-Accounts API מתעדכנים עד שלושה מונים, ולחלק מהמוצרים והפעולות יש מונים משלהם. TikTok שומר את מוני נקודות הקצה עצמאיים זה מזה, כך שנקודת קצה אחת עשויה להיחסם בעוד שאר נקודות האפליקציה ממשיכות להשיב:

Per account and endpoint40 queries a minute for each authorized TikTok account on each Accounts API endpoint
Per app, Accounts API combined600 queries a minute at Basic, and 1,000 at Advanced, Premium and Ultimate
Per app and endpointQueries a second, a minute and a day, set by the app's level
PublishingSix posts a minute and 15 a day per account, on the video and on the photo endpoint
Mentions APIThe app's global limits, with TikTok advising one call per endpoint and account a day
Discovery API10 queries a second on each endpoint, per developer app

מה ארבע רמות האפליקציה מאפשרות?

כל אפליקציות המפתחים מתחילות ב-Basic, ו-TikTok מעלה אפליקציה רמה אחת בכל פעם כשמבקשים זאת תחת My Apps, App Detail, Authorization, עם נימוק. כל רמה קובעת כמה יכולה לקבל נקודת קצה אחת מהאפליקציה, והמכסה המשותפת לקריאות Accounts API מופיעה לצידן:

Basic10 a second, 600 a minute, 864,000 a day; Accounts API combined: 600 a minute
Advanced20 a second, 1,200 a minute, 1,728,000 a day; Accounts API combined: 1,000 a minute
Premium30 a second, 1,800 a minute, 2,592,000 a day; Accounts API combined: 1,000 a minute
Ultimate50 a second, 3,000 a minute, 4,320,000 a day; Accounts API combined: 1,000 a minute

האם רמה גבוהה יותר מרחיבה את המכסה המשותפת?

פעם אחת. המעבר מ-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, ומומלץ קריאה אחת לכל נקודת קצה ולכל חשבון ביום.
עושים את זה עם EasyCoexistence

הוא מחזיר את הקוד וההודעה של 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 קריאות לדקה לכל נקודת קצה כמו כל קריאה אחרת של אותו חשבון.

המשיכו לקרוא

שגיאת TikTok 40100: בקשות נשלחו תכופות מדישגיאת TikTok 40100 פירושה שמגבלת קצב הגבילה את הבקשה. איך מזהים אותה בתגובת HTTP 200, כמה זמן לעצור וכיצד להישאר מתחת למגבלה.מגבלות הפרסום של TikTok API: כמה פוסטים ביוםכמה פוסטים TikTok API מפרסם לכל חשבון: שישה בדקה ו-15 ביום בנקודות הקצה של וידאו ותמונה, ומה קורה מעבר למכסה.אימות וובהוקים (Webhook) של TikTok: כותרת החתימה ואיך בודקים אותהאימות וובהוק של TikTok API for Business באמצעות כותרת Tiktok-Signature וחתימת ה-HMAC-SHA256, עם קוד Node.js מוכן.אזכורים ב-TikTok דרך ה-API: איתור פוסטים ותגובות שמאזכרים חשבוןMentions API של TikTok: פוסטים ותגובות ציבוריים שמתייגים עסק, נקודות הקצה שלו, היקף biz.brand.insights, העיכובים והוובהוק.כשלי פרסום ב-TikTok: spam_risk_too_many_posts, picture_size_check_failed ושאר סיבות הכשלמה משמעות סיבות הכשל של פרסום ב-TikTok ואיך מתקנים אותן: spam_risk_too_many_posts, picture_size_check_failed, video_pull_failed ועוד.ה-API for Business של TikTok לעומת Content Posting APIמדוע ה-API for Business של TikTok ולא developers.tiktok.com: תגובות והוובהוק (Webhook) שלהן, תובנות, החשבונות שמתחברים וחידוש האסימונים.

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-