Rate limit ของ TikTok Events API: 1,000 คำขอ/วินาที (2026)
ตรวจสอบล่าสุดเมื่อ · แหล่งข้อมูลระบุไว้ท้ายหน้านี้
TikTok จำกัดอัตราการเรียกแยกตาม endpoint โดยนับในหน้าต่างเลื่อนหนึ่งนาที endpoint Direct Post ให้ 6 คำขอต่อนาทีต่อ user access token, Query Creator Info ให้ 20, Get Post Status ให้ 30 และ endpoint สำหรับอ่านข้อมูลผู้ใช้และวิดีโอ (/v2/user/info/, /v2/video/query/, /v2/video/list/) ให้ตัวละ 600 ถ้าเกินจะได้ HTTP 429 พร้อมรหัสข้อผิดพลาด rate_limit_exceeded ส่วน Events API เป็นอีกระบบหนึ่งบนอีกโฮสต์หนึ่ง: 1,000 คำขอต่อวินาที เท่ากันในทุกระดับแอปพลิเคชัน และตอบรหัส 40100 เมื่อถูกจำกัด
แต่ละ endpoint ของ TikTok API มี rate limit เท่าไร
ขีดจำกัดถูกกำหนดและบังคับใช้แยกตาม endpoint ไม่ใช่โควตารวมก้อนเดียว ใช้ Direct Post จนหมดก็ไม่ได้ทำให้ Get Post Status ช้าลง และกลับกันก็เช่นกัน
| Endpoint | ขีดจำกัด | ความหมายในทางปฏิบัติ |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | 6 คำขอ / นาที ต่อ user access token | ขีดจำกัดที่ผูกมัดจริงสำหรับคนที่โพสต์ลงหลายบัญชี นับต่อ token จึงนับต่อบัญชีที่เชื่อมต่อ — สิบบัญชีไม่ได้แบ่งกันใช้หกคำขอ แต่ละบัญชีได้หกคำขอของตัวเอง |
| Query Creator Info | 20 คำขอ / นาที ต่อ user access token | ต้องเรียกก่อนทุกโพสต์ เพราะหน้าโพสต์ต้องแสดงตัวเลือกความเป็นส่วนตัวจริงของครีเอเตอร์ นี่คือเหตุผลที่การโพสต์หนึ่งครั้งใช้อย่างน้อยสองคำขอ ไม่ใช่หนึ่ง |
| Get Post Status | 30 คำขอ / นาที ต่อ user access token | ใช้สำหรับ polling สามสิบครั้งต่อนาทีฟังดูเหลือเฟือ จนกว่าคุณจะ poll สิบบัญชีทุกสองวินาที — นั่นคือ 300 |
| /v2/user/info/ | 600 คำขอ / นาที | อ่านข้อมูลโปรไฟล์ |
| /v2/video/query/ | 600 คำขอ / นาที | ตัวชี้วัดของวิดีโอที่ระบุ |
| /v2/video/list/ | 600 คำขอ / นาที | รายการวิดีโอของครีเอเตอร์แบบแบ่งหน้า |
หน้าต่างเวลาคำนวณอย่างไร และจะเกิดอะไรขึ้นเมื่อเกิน
การคำนวณใช้หน้าต่างเลื่อนหนึ่งนาที ไม่ใช่นาทีตามนาฬิกา การโพสต์รัว ๆ หกครั้งตอน 10:00:59 จะไม่รีเซ็ตตอน 10:01:00 — มันนับต่อไปจนถึง 10:01:59
เมื่อเกินเกณฑ์ API จะตอบ HTTP 429 พร้อมรหัสข้อผิดพลาด rate_limit_exceeded TikTok ระบุว่าขอเพิ่มขีดจำกัดได้ผ่านหน้าซัพพอร์ต โดยพิจารณาเป็นรายกรณี
ผลในทางปฏิบัติสำหรับคนที่โพสต์หลายบัญชี: การลองใหม่หลังได้ 429 ต้องเว้นระยะ ไม่ใช่ยิงซ้ำ การลองใหม่ทันทีจะยืดหน้าต่างที่คุณพยายามหนีออกมา
Rate limit ของ TikTok Events API คือกี่คำขอต่อวินาที
หนึ่งพันต่อวินาที และเป็นตัวเลขเดียวกันสำหรับแอปพลิเคชันของนักพัฒนาทุกตัว — นี่คือจุดเดียวที่ TikTok ไม่ให้คุณต้องยื่นขอเพิ่ม
นี่เป็นคนละ API กับทุก endpoint ด้านบน และเป็นจุดที่ทำให้คนพลาดกันบ่อย endpoint ของ Content Posting อยู่บน developers.tiktok.com และนับต่อนาทีต่อ user access token ส่วน Events API เป็นส่วนหนึ่งของ Marketing API บน business-api.tiktok.com และนับเป็น QPS, QPM และ QPD ต่อแอปพลิเคชันของนักพัฒนา สองโฮสต์ สองระบบ สองรหัสข้อผิดพลาด: Marketing API ตอบ "code": 40100 ในขณะที่ developer API ตอบ HTTP 429
แอปพลิเคชันของคุณยังอยู่ในหนึ่งในสี่ระดับรวม — Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50 และทุกแอปเริ่มที่ Basic แต่ endpoint ของ Events ได้รับการยกเว้นจากบันไดนี้อย่างชัดเจน: TikTok ระบุว่าคุณไม่ต้องยื่นขอเปลี่ยนระดับ rate limit สำหรับ Events API เพราะ rate limit เท่ากันทุกระดับ ดังนั้น 1,000 QPS ด้านล่างคือสิ่งที่แอปใหม่เอี่ยมได้ตั้งแต่วันแรก
| Endpoint | ขีดจำกัด | ความหมายในทางปฏิบัติ |
|---|---|---|
| Web Events (/pixel/track/) และ /pixel/batch/ | 1,000 / วินาที · 600,000 / นาที · 86,400,000 / วัน | คอนเวอร์ชันเว็บทั้งฝั่งเบราว์เซอร์และฝั่งเซิร์ฟเวอร์ ตัวเลขรายวันคือ 1,000 × 86,400 พอดี ดังนั้นขีดจำกัดต่อวินาทีจึงเป็นตัวเดียวที่คุณมีโอกาสชนจริง |
| App Events (/app/track/) และ /app/batch/ | 1,000 / วินาที · 600,000 / นาที · 86,400,000 / วัน | คอนเวอร์ชันจากแอปมือถือ |
| Offline Events (/offline/track/) และ /offline/batch/ | 1,000 / วินาที · 600,000 / นาที · 86,400,000 / วัน | คอนเวอร์ชันหน้าร้านและจาก CRM ที่ส่งเข้ามาภายหลัง |
| /event/track/ | 1,000 / วินาที · 600,000 / นาที · 86,400,000 / วัน | endpoint ของ Events API 2.0 |
| Streaming API | 10,000 / วินาที ที่ Basic สูงสุด 50,000 ที่ Ultimate | ขีดจำกัดฝั่ง events ตัวเดียวที่ขึ้นกับบันไดระดับ |
ทำไมการโพสต์ลงสิบบัญชีไม่ได้ใช้เวลานานขึ้นสิบเท่า
เพราะทุกขีดจำกัดด้านบนผูกกับ user access token และหนึ่ง token คือหนึ่งบัญชีที่เชื่อมต่อ สิบบัญชีคือสิบถังอิสระ ถังละหกโพสต์ต่อนาที
สิ่งที่ต้องทำต่อคิวกันจริง ๆ คือโครงสร้างพื้นฐานของคุณเอง: ไฟล์วิดีโอเดียวที่อัปโหลดสิบครั้งคือการส่งสิบครั้ง ขีดจำกัดที่ชนก่อนแทบไม่เคยเป็นของ TikTok แต่เป็นแบนด์วิดท์
คำถามที่พบบ่อย
- Rate limit ของ TikTok API นับต่อแอปหรือต่อผู้ใช้
- endpoint ของ Content Posting ระบุในเอกสารว่านับต่อ user access token — จึงนับต่อบัญชีที่เชื่อมต่อ TikTok ไม่ได้เผยแพร่เพดานรวมระดับแอปแยกต่างหากสำหรับ endpoint เหล่านี้ และระบุว่าขีดจำกัดถูกกำหนดและบังคับใช้แยกกันสำหรับแต่ละ API
- TikTok ส่ง error อะไรกลับมาเมื่อเกิน rate limit
- สถานะ HTTP 429 พร้อมรหัสข้อผิดพลาด rate_limit_exceeded ใน response body
- ขอเพิ่ม rate limit ของ TikTok API ได้ไหม
- ได้ เอกสารของ TikTok ระบุว่าขอขีดจำกัดที่สูงขึ้นได้ผ่านหน้าซัพพอร์ต และแต่ละคำขอจะได้รับการพิจารณา
- Rate limit ต่อวินาทีของ TikTok Events API คือเท่าไร
- 1,000 คำขอต่อวินาที 600,000 ต่อนาที และ 86,400,000 ต่อวัน เท่ากันทั้ง /event/track/, Web Events, App Events และ Offline Events TikTok ใช้ตัวเลขเดียวกันในทั้งสี่ระดับแอปพลิเคชัน และระบุว่าไม่ต้องยื่นขอเพิ่มสำหรับ Events API
- Rate limit ของ Events API เท่ากับของ Content Posting API ไหม
- ไม่ และไม่ได้เป็นระบบเดียวกันด้วยซ้ำ Content Posting มีเอกสารอยู่บน developers.tiktok.com นับต่อนาทีต่อ user access token และตอบ HTTP 429 พร้อม rate_limit_exceeded ส่วน Events API เป็นของ Marketing API บน business-api.tiktok.com นับเป็นคำขอต่อวินาที ต่อนาที และต่อวัน ต่อแอปพลิเคชันของนักพัฒนา และตอบรหัส 40100
- โพสต์วิดีโอ TikTok ผ่าน API ได้กี่คลิปต่อนาที
- หกคลิปต่อบัญชีที่เชื่อมต่อ เพราะ endpoint Direct Post ให้ 6 คำขอต่อนาทีต่อ user access token ถ้ามีสิบบัญชีก็เป็นหกสิบ เพราะแต่ละบัญชีมีขีดจำกัดของตัวเอง
แหล่งข้อมูล
- TikTok for Developers — Rate Limits on API Requests — อ่านเมื่อ .
- TikTok API for Business — Rate limits (Marketing API, incl. Events API) — อ่านเมื่อ .
- TikTok for Developers — Content Posting API, Direct Post — อ่านเมื่อ .
- TikTok for Developers — Query Creator Info — อ่านเมื่อ .
ตัวเลขเหล่านี้มาจากเอกสารของบริษัทอื่น ซึ่งอาจเปลี่ยนได้โดยไม่แจ้งล่วงหน้า และไม่มีระบบใดในหน้านี้ตรวจสอบให้อัตโนมัติ แหล่งข้อมูลทุกรายการจึงระบุวันที่อ่านไว้ แหล่งข้อมูลในหน้านี้จะถูกอ่านซ้ำทุกไตรมาส
หน้านี้ทำขึ้นอย่างไร: เขียนโดยมี AI ช่วย จากแหล่งข้อมูลที่ระบุไว้ในหน้านี้ ซึ่งอ่านเมื่อ .