Límite de tasa de la Events API de TikTok: 1.000/s (2026)
Última revisión · fuentes citadas al pie de esta página
TikTok limita cada endpoint por separado, sobre una ventana deslizante de un minuto. El endpoint Direct Post permite 6 peticiones por minuto por token de acceso de usuario, Query Creator Info permite 20, Get Post Status permite 30 y los endpoints de lectura de usuario y vídeo (/v2/user/info/, /v2/video/query/, /v2/video/list/) permiten 600 cada uno. Si te pasas, recibes un HTTP 429 con el código de error rate_limit_exceeded. La Events API es un sistema aparte en otro host: 1.000 peticiones por segundo, iguales en todos los niveles de aplicación, y responde con el código 40100 cuando te limita.
¿Cuál es el límite de tasa de cada endpoint de la API de TikTok?
Los límites se fijan y se aplican por endpoint, no como un presupuesto compartido. Agotar Direct Post no frena Get Post Status, y viceversa.
| Endpoint | Límite | Qué significa en la práctica |
|---|---|---|
| Direct Post (/v2/post/publish/video/init/) | 6 peticiones / minuto por token de acceso de usuario | El límite que de verdad aprieta a quien publica en varias cuentas. Es por token, es decir, por cuenta conectada: diez cuentas no se reparten seis peticiones, cada una tiene seis. |
| Query Creator Info | 20 peticiones / minuto por token de acceso de usuario | Se llama antes de cada publicación, porque la interfaz de publicación debe mostrar las opciones de privacidad reales del creador. Por eso un flujo de publicación cuesta como mínimo dos llamadas, no una. |
| Get Post Status | 30 peticiones / minuto por token de acceso de usuario | Consultas de estado. Treinta por minuto parece generoso hasta que consultas diez cuentas cada dos segundos: eso son 300. |
| /v2/user/info/ | 600 peticiones / minuto | Lecturas de perfil. |
| /v2/video/query/ | 600 peticiones / minuto | Métricas de vídeos concretos. |
| /v2/video/list/ | 600 peticiones / minuto | Listado paginado de los vídeos de un creador. |
¿Cómo se calcula la ventana y qué pasa cuando la superas?
El cálculo usa una ventana deslizante de un minuto, no un minuto fijo de reloj. Una ráfaga de seis publicaciones a las 10:00:59 no se reinicia a las 10:01:00: sigue contando hasta las 10:01:59.
Por encima del umbral, la API responde HTTP 429 con el código de error rate_limit_exceeded. TikTok indica que los límites pueden ampliarse a petición a través de su página de soporte, y que cada caso se revisa por separado.
La consecuencia práctica para quien publica en varias cuentas: un reintento tras un 429 debe esperar, no repetir. Un reintento inmediato alarga la ventana de la que intenta salir.
¿Cuál es el límite de tasa de la Events API de TikTok, en peticiones por segundo?
Mil por segundo, y es la misma cifra para todas las aplicaciones de desarrollador: es el único sitio donde TikTok no te obliga a solicitar más.
Es una API distinta de todos los endpoints anteriores, y ahí es donde mucha gente se confunde. Los endpoints de Content Posting viven en developers.tiktok.com y se cuentan por minuto y por token de acceso de usuario. La Events API forma parte de la Marketing API en business-api.tiktok.com y se cuenta en QPS, QPM y QPD contra tu aplicación de desarrollador. Dos hosts, dos sistemas, dos códigos de error: la Marketing API responde "code": 40100 donde la API de desarrolladores responde HTTP 429.
Tu aplicación, además, está en uno de cuatro niveles globales: Basic 10 QPS, Advanced 20, Premium 30, Ultimate 50, y toda app empieza en Basic. Los endpoints de Events quedan expresamente fuera de esa escala: TikTok indica que no necesitas solicitar un cambio de nivel de límite para la Events API, porque el límite es el mismo en todos los niveles. Así que los 1.000 QPS de abajo son lo que obtiene una app recién creada desde el primer día.
| Endpoint | Límite | Qué significa en la práctica |
|---|---|---|
| Web Events (/pixel/track/) y /pixel/batch/ | 1.000 / segundo · 600.000 / minuto · 86.400.000 / día | Conversiones web desde el navegador y desde el servidor. La cifra diaria es exactamente 1.000 × 86.400, así que el límite por segundo es el único que puedes alcanzar de forma realista. |
| App Events (/app/track/) y /app/batch/ | 1.000 / segundo · 600.000 / minuto · 86.400.000 / día | Conversiones de apps móviles. |
| Offline Events (/offline/track/) y /offline/batch/ | 1.000 / segundo · 600.000 / minuto · 86.400.000 / día | Conversiones en tienda física y de CRM enviadas a posteriori. |
| /event/track/ | 1.000 / segundo · 600.000 / minuto · 86.400.000 / día | El endpoint de la Events API 2.0. |
| Streaming API | 10.000 / segundo en Basic, hasta 50.000 en Ultimate | El único límite del lado de eventos que sí sigue la escala de niveles. |
¿Por qué publicar en diez cuentas no tarda diez veces más?
Porque todos los límites anteriores se aplican a un token de acceso de usuario, y un token es una cuenta conectada. Diez cuentas son diez cubos independientes de seis publicaciones por minuto.
Lo que sí se encola es tu propia infraestructura: un mismo archivo de vídeo subido diez veces son diez transferencias. El límite que muerde primero casi nunca es el de TikTok: es el ancho de banda.
Preguntas frecuentes
- ¿Los límites de tasa de la API de TikTok son por app o por usuario?
- Los endpoints de Content Posting están documentados por token de acceso de usuario, es decir, por cuenta conectada. TikTok no publica un techo aparte a nivel de app para estos endpoints, e indica que los límites se fijan y se aplican por separado para cada API.
- ¿Qué error devuelve TikTok cuando se supera un límite de tasa?
- Un estado HTTP 429, con el código de error rate_limit_exceeded en el cuerpo de la respuesta.
- ¿Se pueden ampliar los límites de tasa de la API de TikTok?
- Sí. La documentación de TikTok indica que se pueden solicitar límites más altos a través de su página de soporte, y que cada solicitud se revisa.
- ¿Cuál es el límite por segundo de la Events API de TikTok?
- 1.000 peticiones por segundo, 600.000 por minuto y 86.400.000 al día, por igual para /event/track/, Web Events, App Events y Offline Events. TikTok aplica la misma cifra en los cuatro niveles de aplicación e indica que no necesitas solicitar una ampliación para la Events API.
- ¿El límite de la Events API es el mismo que el de la Content Posting API?
- No, y ni siquiera son el mismo sistema. Content Posting está documentada en developers.tiktok.com, se cuenta por minuto contra un token de acceso de usuario y responde HTTP 429 con rate_limit_exceeded. La Events API pertenece a la Marketing API en business-api.tiktok.com, se cuenta en peticiones por segundo, minuto y día contra tu aplicación de desarrollador y responde con el código 40100.
- ¿Cuántos vídeos de TikTok puedo publicar por minuto a través de la API?
- Seis por cuenta conectada, ya que el endpoint Direct Post permite 6 peticiones por minuto por token de acceso de usuario. Con diez cuentas conectadas son sesenta, porque cada cuenta tiene su propio límite.
Fuentes
- TikTok for Developers — Rate Limits on API Requests — consultada el .
- TikTok API for Business — Rate limits (Marketing API, incl. Events API) — consultada el .
- TikTok for Developers — Content Posting API, Direct Post — consultada el .
- TikTok for Developers — Query Creator Info — consultada el .
Estas cifras vienen de la documentación de otra empresa, que puede cambiar sin previo aviso y que nada de lo que hay aquí verifica automáticamente. Por eso cada fuente lleva la fecha en que se consultó. Las fuentes de esta página se vuelven a leer cada trimestre.
Cómo se hizo esta página: redactada con ayuda de IA a partir de las fuentes citadas en esta página, consultadas el .