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.

EndpointLímiteQué significa en la práctica
Direct Post (/v2/post/publish/video/init/)6 peticiones / minuto por token de acceso de usuarioEl 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 Info20 peticiones / minuto por token de acceso de usuarioSe 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 Status30 peticiones / minuto por token de acceso de usuarioConsultas de estado. Treinta por minuto parece generoso hasta que consultas diez cuentas cada dos segundos: eso son 300.
/v2/user/info/600 peticiones / minutoLecturas de perfil.
/v2/video/query/600 peticiones / minutoMétricas de vídeos concretos.
/v2/video/list/600 peticiones / minutoListado paginado de los vídeos de un creador.
Límites publicados, consultados en la documentación para desarrolladores de TikTok el 22 de septiembre de 2026.

¿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.

EndpointLímiteQué significa en la práctica
Web Events (/pixel/track/) y /pixel/batch/1.000 / segundo · 600.000 / minuto · 86.400.000 / díaConversiones 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íaConversiones de apps móviles.
Offline Events (/offline/track/) y /offline/batch/1.000 / segundo · 600.000 / minuto · 86.400.000 / díaConversiones en tienda física y de CRM enviadas a posteriori.
/event/track/1.000 / segundo · 600.000 / minuto · 86.400.000 / díaEl endpoint de la Events API 2.0.
Streaming API10.000 / segundo en Basic, hasta 50.000 en UltimateEl único límite del lado de eventos que sí sigue la escala de niveles.
Límites de la Events API, idénticos en Basic, Advanced, Premium y Ultimate. Consultados en la documentación de la API para empresas de TikTok el 27 de septiembre de 2026.

¿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

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 .