Giới hạn TikTok Events API: 1.000 yêu cầu/giây (2026)
Kiểm tra lần cuối · nguồn liệt kê ở cuối trang này
TikTok giới hạn tần suất riêng cho từng endpoint, tính trên cửa sổ trượt một phút. Endpoint Direct Post cho phép 6 yêu cầu mỗi phút trên mỗi user access token, Query Creator Info cho phép 20, Get Post Status cho phép 30, và các endpoint đọc người dùng và video (/v2/user/info/, /v2/video/query/, /v2/video/list/) mỗi cái cho phép 600. Vượt quá sẽ nhận HTTP 429 với mã lỗi rate_limit_exceeded. Events API là một hệ thống khác trên một host khác: 1.000 yêu cầu mỗi giây, như nhau ở mọi cấp ứng dụng, và trả về mã 40100 khi bị chặn.
Giới hạn tần suất của từng endpoint TikTok API là bao nhiêu?
Các giới hạn được đặt và áp dụng riêng cho từng endpoint, không phải một ngân sách chung. Dùng hết Direct Post không làm chậm Get Post Status, và ngược lại.
| Endpoint | Giới hạn | Ý nghĩa trong thực tế |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | 6 yêu cầu / phút mỗi user access token | Giới hạn thực sự ràng buộc với ai đăng lên nhiều tài khoản. Nó tính theo token, tức theo từng tài khoản đã kết nối — mười tài khoản không chia nhau sáu yêu cầu, mỗi tài khoản có sáu yêu cầu riêng. |
| Query Creator Info | 20 yêu cầu / phút mỗi user access token | Được gọi trước mỗi bài đăng, vì giao diện đăng bài phải hiển thị đúng các tùy chọn quyền riêng tư của nhà sáng tạo. Đó là lý do một lần đăng tốn ít nhất hai lệnh gọi chứ không phải một. |
| Get Post Status | 30 yêu cầu / phút mỗi user access token | Dùng để polling. Ba mươi mỗi phút nghe có vẻ rộng rãi cho đến khi bạn poll mười tài khoản mỗi hai giây — tức là 300. |
| /v2/user/info/ | 600 yêu cầu / phút | Đọc hồ sơ. |
| /v2/video/query/ | 600 yêu cầu / phút | Chỉ số của các video cụ thể. |
| /v2/video/list/ | 600 yêu cầu / phút | Danh sách video của một nhà sáng tạo, có phân trang. |
Cửa sổ được tính thế nào, và chuyện gì xảy ra khi bạn vượt quá?
Phép tính dùng cửa sổ trượt một phút, không phải phút cố định theo đồng hồ. Một loạt sáu bài đăng lúc 10:00:59 không được đặt lại lúc 10:01:00 — nó tiếp tục được tính cho đến 10:01:59.
Vượt ngưỡng, API trả về HTTP 429 với mã lỗi rate_limit_exceeded. TikTok cho biết có thể xin nâng giới hạn qua trang hỗ trợ, được xem xét từng trường hợp.
Hệ quả thực tế với người đăng lên nhiều tài khoản: thử lại sau lỗi 429 phải giãn cách, không phải lặp lại ngay. Thử lại tức thì sẽ kéo dài chính cửa sổ mà bạn đang cố thoát ra.
Giới hạn tần suất của TikTok Events API là bao nhiêu yêu cầu mỗi giây?
Một nghìn mỗi giây, và đó là cùng một con số cho mọi ứng dụng của nhà phát triển — đây là chỗ duy nhất TikTok không bắt bạn phải xin thêm.
Đây là một API khác hẳn với mọi endpoint ở trên, và đó là điểm khiến nhiều người nhầm. Các endpoint Content Posting nằm trên developers.tiktok.com và được tính theo phút, trên mỗi user access token. Events API thuộc Marketing API trên business-api.tiktok.com, và được tính bằng QPS, QPM và QPD trên ứng dụng của nhà phát triển. Hai host, hai hệ thống, hai mã lỗi: Marketing API trả về "code": 40100 còn developer API trả về HTTP 429.
Ứng dụng của bạn cũng nằm ở một trong bốn cấp chung — Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50, và mọi ứng dụng bắt đầu ở Basic. Các endpoint Events được miễn rõ ràng khỏi thang này: TikTok cho biết bạn không cần xin đổi cấp giới hạn tần suất cho Events API, vì giới hạn như nhau ở mọi cấp. Vì vậy 1.000 QPS bên dưới là thứ một ứng dụng mới tinh nhận được ngay ngày đầu.
| Endpoint | Giới hạn | Ý nghĩa trong thực tế |
|---|---|---|
| Web Events (/pixel/track/) và /pixel/batch/ | 1,000 / giây · 600,000 / phút · 86,400,000 / ngày | Chuyển đổi web phía trình duyệt và phía máy chủ. Con số theo ngày đúng bằng 1.000 × 86.400, nên giới hạn theo giây là cái duy nhất bạn có thể chạm tới trong thực tế. |
| App Events (/app/track/) và /app/batch/ | 1,000 / giây · 600,000 / phút · 86,400,000 / ngày | Chuyển đổi từ ứng dụng di động. |
| Offline Events (/offline/track/) và /offline/batch/ | 1,000 / giây · 600,000 / phút · 86,400,000 / ngày | Chuyển đổi tại cửa hàng và từ CRM, gửi lên sau khi đã xảy ra. |
| /event/track/ | 1,000 / giây · 600,000 / phút · 86,400,000 / ngày | Endpoint của Events API 2.0. |
| Streaming API | 10,000 / giây ở Basic, tới 50,000 ở Ultimate | Giới hạn duy nhất phía events có đi theo thang cấp. |
Vì sao đăng lên mười tài khoản không lâu gấp mười lần?
Vì mọi giới hạn ở trên đều gắn với một user access token, và một token là một tài khoản đã kết nối. Mười tài khoản là mười thùng độc lập, mỗi thùng sáu bài đăng mỗi phút.
Thứ thực sự phải xếp hàng là hạ tầng của chính bạn: một tệp video tải lên mười lần là mười lần truyền. Giới hạn chạm tới đầu tiên gần như không bao giờ là của TikTok, mà là băng thông.
Câu hỏi thường gặp
- Giới hạn tần suất của TikTok API tính theo ứng dụng hay theo người dùng?
- Các endpoint Content Posting được ghi trong tài liệu là tính theo user access token — tức theo từng tài khoản đã kết nối. TikTok không công bố một trần riêng cho toàn ứng dụng với các endpoint này, và cho biết các giới hạn được đặt và áp dụng riêng cho từng API.
- TikTok trả về lỗi gì khi vượt giới hạn tần suất?
- Mã trạng thái HTTP 429, với mã lỗi rate_limit_exceeded trong phần thân phản hồi.
- Có thể nâng giới hạn tần suất của TikTok API không?
- Có. Tài liệu của TikTok cho biết có thể xin giới hạn cao hơn qua trang hỗ trợ, và mỗi yêu cầu đều được xem xét.
- Giới hạn mỗi giây của TikTok Events API là bao nhiêu?
- 1.000 yêu cầu mỗi giây, 600.000 mỗi phút và 86.400.000 mỗi ngày, như nhau cho /event/track/, Web Events, App Events và Offline Events. TikTok áp dụng cùng con số ở cả bốn cấp ứng dụng và cho biết bạn không cần xin tăng cho Events API.
- Giới hạn của Events API có giống giới hạn của Content Posting API không?
- Không, và chúng thậm chí không cùng một hệ thống. Content Posting có tài liệu trên developers.tiktok.com, tính theo phút trên một user access token, và trả về HTTP 429 với rate_limit_exceeded. Events API thuộc Marketing API trên business-api.tiktok.com, được tính theo yêu cầu mỗi giây, mỗi phút và mỗi ngày trên ứng dụng của nhà phát triển, và trả về mã 40100.
- Tôi có thể đăng bao nhiêu video TikTok mỗi phút qua API?
- Sáu video trên mỗi tài khoản đã kết nối, vì endpoint Direct Post cho phép 6 yêu cầu mỗi phút trên mỗi user access token. Với mười tài khoản đã kết nối là sáu mươi, vì mỗi tài khoản có giới hạn riêng.
Nguồn
- TikTok for Developers — Rate Limits on API Requests — đọc vào .
- TikTok API for Business — Rate limits (Marketing API, incl. Events API) — đọc vào .
- TikTok for Developers — Content Posting API, Direct Post — đọc vào .
- TikTok for Developers — Query Creator Info — đọc vào .
Các con số này đến từ tài liệu của một công ty khác, có thể thay đổi mà không báo trước và không có gì ở đây tự động kiểm chứng. Vì vậy mỗi nguồn đều ghi ngày được đọc. Các nguồn trên trang này được đọc lại mỗi quý.
Trang này được làm như thế nào: soạn với sự hỗ trợ của AI từ các nguồn liệt kê trên trang này, đọc vào .