TikTok Events API 요청 한도: 초당 1,000건 (2026)
최종 확인일 · 출처는 이 페이지 하단에 있습니다
TikTok은 엔드포인트마다 따로 요청 한도를 두고, 1분 슬라이딩 윈도로 계산합니다. Direct Post 엔드포인트는 사용자 액세스 토큰당 분당 6건, Query Creator Info는 20건, Get Post Status는 30건, 사용자·동영상 조회 엔드포인트(/v2/user/info/, /v2/video/query/, /v2/video/list/)는 각각 600건입니다. 초과하면 HTTP 429와 오류 코드 rate_limit_exceeded가 반환됩니다. Events API는 다른 호스트에 있는 별개의 시스템으로, 초당 1,000건이며 모든 애플리케이션 레벨에서 같고, 제한에 걸리면 코드 40100을 반환합니다.
TikTok API 엔드포인트별 요청 한도는 얼마인가요?
한도는 하나의 공유 예산이 아니라 엔드포인트별로 설정되고 적용됩니다. Direct Post를 다 써도 Get Post Status가 느려지지 않고, 그 반대도 마찬가지입니다.
| 엔드포인트 | 한도 | 실제 의미 |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | 6 requests / minute per user access token | 여러 계정에 게시하는 사람에게 실제로 걸리는 한도입니다. 토큰별, 즉 연결된 계정별이므로 계정 10개가 6건을 나눠 쓰는 것이 아니라 각각 6건씩 가집니다. |
| Query Creator Info | 20 requests / minute per user access token | 게시 UI에 크리에이터의 실제 공개 범위 옵션을 보여 줘야 하므로 게시할 때마다 먼저 호출합니다. 게시 한 번에 호출이 한 번이 아니라 최소 두 번 드는 이유입니다. |
| Get Post Status | 30 requests / minute per user access token | 폴링용입니다. 분당 30건은 넉넉해 보이지만, 계정 10개를 2초마다 폴링하면 300건이 됩니다. |
| /v2/user/info/ | 600 requests / minute | 프로필 조회. |
| /v2/video/query/ | 600 requests / minute | 특정 동영상의 지표. |
| /v2/video/list/ | 600 requests / minute | 크리에이터 동영상 목록(페이지 단위). |
윈도는 어떻게 계산되고, 초과하면 어떻게 되나요?
계산에는 시계 기준의 고정된 1분이 아니라 1분 슬라이딩 윈도가 쓰입니다. 10:00:59에 게시물 6개를 몰아서 보내면 10:01:00에 초기화되지 않고, 10:01:59까지 계속 집계됩니다.
임계값을 넘으면 API는 HTTP 429와 오류 코드 rate_limit_exceeded를 반환합니다. TikTok에 따르면 지원 페이지를 통해 한도 상향을 요청할 수 있으며, 건별로 검토됩니다.
여러 계정에 게시하는 사람에게 주는 실질적인 결론: 429가 오면 재시도는 반복이 아니라 간격을 두고(백오프) 해야 합니다. 즉시 재시도하면 벗어나려는 윈도 자체가 길어집니다.
TikTok Events API 요청 한도는 초당 몇 건인가요?
초당 1,000건이며, 모든 개발자 애플리케이션에 같은 숫자가 적용됩니다. TikTok이 상향 신청을 요구하지 않는 유일한 곳입니다.
이것은 위의 모든 엔드포인트와 다른 API이고, 많은 사람이 헷갈리는 부분이 바로 여기입니다. Content Posting 엔드포인트는 developers.tiktok.com에 있고, 사용자 액세스 토큰별로 분 단위로 집계됩니다. Events API는 business-api.tiktok.com에 있는 Marketing API의 일부이며, 개발자 애플리케이션 기준으로 QPS, QPM, QPD로 집계됩니다. 호스트 두 개, 시스템 두 개, 오류 코드 두 개: 개발자 API가 HTTP 429를 반환하는 자리에서 Marketing API는 "code": 40100을 반환합니다.
애플리케이션은 네 가지 글로벌 레벨 중 하나에도 속합니다. Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50이며, 모든 앱은 Basic에서 시작합니다. Events 엔드포인트는 이 단계에서 명시적으로 제외됩니다. TikTok에 따르면 요청 한도가 모든 레벨에서 같기 때문에 Events API에 대해서는 레벨 변경을 신청할 필요가 없습니다. 즉, 아래의 1,000 QPS는 막 만든 앱도 첫날부터 받는 수치입니다.
| 엔드포인트 | 한도 | 실제 의미 |
|---|---|---|
| Web Events (/pixel/track/) and /pixel/batch/ | 1,000 / second · 600,000 / minute · 86,400,000 / day | 브라우저 및 서버 측 웹 전환. 일일 수치가 정확히 1,000 × 86,400이므로, 현실적으로 닿을 수 있는 것은 초당 한도뿐입니다. |
| App Events (/app/track/) and /app/batch/ | 1,000 / second · 600,000 / minute · 86,400,000 / day | 모바일 앱 전환. |
| Offline Events (/offline/track/) and /offline/batch/ | 1,000 / second · 600,000 / minute · 86,400,000 / day | 매장 및 CRM 전환을 사후에 보내는 것. |
| /event/track/ | 1,000 / second · 600,000 / minute · 86,400,000 / day | Events API 2.0 엔드포인트. |
| Streaming API | 10,000 / second at Basic, up to 50,000 at Ultimate | 이벤트 쪽에서 유일하게 레벨 단계를 따르는 한도입니다. |
계정 10개에 게시해도 시간이 10배 걸리지 않는 이유는?
위의 모든 한도가 사용자 액세스 토큰 단위이고, 토큰 하나가 연결된 계정 하나이기 때문입니다. 계정 10개는 분당 6건짜리 독립된 버킷 10개입니다.
직렬로 처리되는 것은 내 인프라 쪽입니다. 동영상 파일 하나를 10번 업로드하면 전송도 10번입니다. 가장 먼저 걸리는 한도는 거의 언제나 TikTok의 것이 아니라 대역폭입니다.
자주 묻는 질문
- TikTok API 요청 한도는 앱 단위인가요, 사용자 단위인가요?
- Content Posting 엔드포인트는 사용자 액세스 토큰 단위, 즉 연결된 계정 단위로 문서화되어 있습니다. TikTok은 이 엔드포인트들에 대해 앱 전체 상한을 따로 공개하지 않으며, 한도는 API마다 따로 설정되고 적용된다고 밝힙니다.
- 요청 한도를 넘으면 TikTok은 어떤 오류를 반환하나요?
- HTTP 상태 429이며, 응답 본문에 오류 코드 rate_limit_exceeded가 담깁니다.
- TikTok API 요청 한도를 늘릴 수 있나요?
- 네. TikTok 문서에 따르면 지원 페이지를 통해 더 높은 한도를 요청할 수 있고, 요청마다 검토를 거칩니다.
- TikTok Events API 요청 한도는 초당 얼마인가요?
- 초당 1,000건, 분당 600,000건, 하루 86,400,000건이며, /event/track/, Web Events, App Events, Offline Events 모두 같습니다. TikTok은 네 가지 애플리케이션 레벨 모두에 같은 수치를 적용하고, Events API는 상향 신청이 필요 없다고 밝힙니다.
- Events API와 Content Posting API의 요청 한도는 같은가요?
- 아닙니다. 애초에 같은 시스템도 아닙니다. Content Posting은 developers.tiktok.com에 문서화되어 있고, 사용자 액세스 토큰 기준으로 분 단위로 집계되며, HTTP 429와 rate_limit_exceeded를 반환합니다. Events API는 business-api.tiktok.com의 Marketing API에 속하고, 개발자 애플리케이션 기준으로 초·분·일 단위로 집계되며, 코드 40100을 반환합니다.
- API로 1분에 TikTok 동영상을 몇 개 게시할 수 있나요?
- Direct Post 엔드포인트가 사용자 액세스 토큰당 분당 6건을 허용하므로, 연결된 계정 하나당 6개입니다. 계정 10개를 연결했다면 계정마다 한도가 따로 있으므로 60개입니다.
출처
- 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의 도움을 받아 작성. 출처 확인일 .