Límites de tasa de la API de TikTok: peticiones por cuenta, app y endpoint
La API for Business de TikTok limita las llamadas en tres niveles a la vez: 40 por minuto por cuenta autorizada en cada endpoint de la API de Accounts, un presupuesto combinado de la API de Accounts por app de desarrollador de 600 por minuto en Basic y 1,000 por encima, y límites por endpoint para la app de 10 por segundo, 600 por minuto y 864,000 al día en Basic, que suben a 50 por segundo en Ultimate.
easyCoexistence publica publicaciones, lee las métricas y responde a comentarios en TikTok para Claude, ChatGPT o tu propio código a través de la API for Business de TikTok, devuelve el código y el mensaje de TikTok cuando una llamada está limitada, y sigue cada publicación hasta que TikTok la completa o la falla.
Consultas por minuto por cuenta de TikTok autorizada en cada endpoint de la API de Accounts, una sola cifra independiente del nivel de la app.
Presupuesto para todos los endpoints de la API de Accounts combinados por app de desarrollador en Advanced, Premium y Ultimate; Basic recibe 600.
Límite por endpoint en Ultimate, el nivel más alto de app, junto a 3,000 consultas por minuto y 4,320,000 al día.
Estado que TikTok devuelve junto con sus códigos de retorno, incluidos los 4xxxx como 40100; solo el código 0 significa éxito.
Límite de tasa para cada endpoint de la API de Discovery por app de desarrollador.
Cuándo se reinician los límites diarios; tras un límite por minuto, TikTok pide una pausa de 5 minutos en su lugar.
¿Qué límites se aplican a una llamada a la API de TikTok?
Hasta tres contadores se mueven con cada llamada a la API de Accounts, y algunos productos y acciones llevan cuentas propias. TikTok mantiene los contadores de endpoint independientes, así que un endpoint puede verse limitado mientras los demás endpoints de la app siguen respondiendo:
¿Qué permiten los cuatro niveles de app?
Todas las apps de desarrollador empiezan en Basic, y TikTok sube una app un nivel cada vez cuando se solicita en My Apps, App Detail, Authorization, con un motivo. Cada nivel fija lo que un solo endpoint puede consumir de la app, junto al presupuesto combinado para las llamadas a la API de Accounts:
¿Un nivel superior aumenta el presupuesto de la API de Accounts?
Una vez. Pasar de Basic a Advanced eleva el presupuesto combinado de la API de Accounts de 600 a 1,000 consultas por minuto, y se mantiene en 1,000 en Premium y Ultimate, mientras que los límites por endpoint por segundo y por día siguen subiendo. El límite de 40 por minuto por cuenta y endpoint no cambia en absoluto con el nivel, así que una cuenta muy activa se limita a 40 llamadas por minuto en un endpoint, sea cual sea el nivel de la app.
¿Cómo se suman los límites entre muchas cuentas?
El límite por cuenta se multiplica con cada cuenta; el presupuesto de la app no. Diez cuentas pueden hacer cada una 40 llamadas por minuto a /business/comment/list/, 400 en total, pero veinte haciendo lo mismo necesitarían 800, por encima de los 600 que una app Basic tiene para sus llamadas combinadas a la API de Accounts antes de contar cualquier otro endpoint. Por encima de Basic, ese presupuesto compartido llega como máximo a 1,000 por minuto.
¿Qué pasa cuando una llamada supera un límite?
TikTok limita ese endpoint. Su guía de límites de tasa indica el código 40100 para una llamada limitada, que llega en el cuerpo de una respuesta HTTP 200, y el endpoint permanece cerrado 5 minutos tras un límite por minuto, o hasta que los contadores diarios se reinician a las 00:00 UTC tras uno diario, mientras los demás endpoints de la app siguen respondiendo. Detectarlo en el código y reintentarlo bien se explica en el error 40100.
¿Los límites de publicación son límites de tasa?
No, cuentan publicaciones y no llamadas, y tienen una página propia. TikTok permite a una cuenta publicar seis publicaciones por minuto y 15 al día a través de /business/video/publish/, y lo mismo por /business/photo/publish/. Una publicación que supere ese recuento falla con spam_risk_too_many_posts en su estado de publicación, mientras que un límite de tasa rechaza la llamada en sí.
¿Qué hábitos consumen los límites más rápido?
El sondeo. Consultar un estado de publicación o una lista de comentarios con un temporizador gasta las 40 llamadas por minuto de la cuenta en ese endpoint, haya cambiado algo o no, y los webhooks de TikTok existen para sustituirlo: los eventos de publicación informan de cada etapa de una publicación, y comment.update informa de un comentario nuevo en cinco minutos. Leer por páginas, 20 publicaciones o 30 comentarios por llamada, y pedir las menciones una vez al día mantienen bajo el resto del consumo.
¿Cómo gestiona easyCoexistence una llamada limitada de TikTok?
Transmite la respuesta de TikTok en lugar de ocultarla. Una llamada de herramienta que TikTok limita, como list_social_comments, reply_to_comment o get_tiktok_publish_status, llega a la IA como un error que indica el código 40100 con el mensaje de TikTok, y no se reintenta por sí sola. Las publicaciones siguen otro camino, ya que publish_tiktok_post entrega cada una a la cola de easyCoexistence, ahora o a una hora programada:
- La cola espera y reintenta a los 5 minutos, 30 minutos y 2 horas cuando una respuesta llega como HTTP 429.
- TikTok envía 40100 dentro de una respuesta HTTP 200, así que una publicación limitada falla con el mensaje de TikTok y queda en Needs attention a la espera de Retry.
- Un 40100 en una de las comprobaciones de estado de la cola también hace fallar la publicación, aunque TikTok puede tenerla ya: revisa las últimas publicaciones de la cuenta antes de Retry.
- Una publicación que falla en segundo plano envía un correo al propietario, como máximo una vez por canal cada 3 horas.
¿Qué llamadas a TikTok hace easyCoexistence para una cuenta?
Unas pocas, y cuentan contra los límites de la cuenta igual que las tuyas:
- /business/get/ aproximadamente cada 6 horas, para comprobar que la cuenta sigue respondiendo.
- Una llamada de publicación por publicación, y después /business/publish/status/ aproximadamente cada 20 segundos hasta que TikTok complete o falle la publicación, durante un máximo de 2 horas.
- Con reglas de comentarios o automatizaciones activas, una llamada a /business/comment/list/ por cada comentario nuevo de primer nivel para leer su autor, y una llamada por cada respuesta publicada.
- Llamadas de herramienta solo cuando la IA o tu código lo piden, con 20 publicaciones o 30 comentarios por lectura.
Errores comunes
- Detectar la limitación por el estado HTTP. TikTok responde 40100 con HTTP 200, así que una comprobación de res.ok o de 429 la pasa por alto; lee el código en el cuerpo.
- Subir el nivel de la app para arreglar una cuenta muy activa. Las 40 llamadas por minuto por cuenta y endpoint son iguales en los cuatro niveles, así que reparte las llamadas de esa cuenta en el tiempo.
- Pedir datos de Mentions muchas veces al día. TikTok los actualiza una vez, entre medianoche y las 7 am UTC, y recomienda una llamada por endpoint y cuenta al día.
De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Cuál es el límite de tasa de la API de TikTok por cuenta?
40 consultas por minuto en cada endpoint de la API de Accounts por cada cuenta de TikTok autorizada, dentro del presupuesto combinado de la app de desarrollador: 600 por minuto en Basic o 1,000 por encima.
¿Los límites de TikTok se cuentan por endpoint?
Sí. La guía de TikTok dice que los límites específicos de cada endpoint son independientes, así que alcanzar el límite de un endpoint no detiene las llamadas a otro.
¿Cómo subo mi límite de tasa de la API de TikTok?
Solicítalo en My Apps, App Detail, Authorization e indica un motivo. Los niveles suben de uno en uno, de Basic a Advanced, luego Premium y después Ultimate.
¿Las llamadas a través de easyCoexistence cuentan para los límites de TikTok?
Sí. Se ejecutan como la cuenta conectada con su token, así que cuentan para sus 40 llamadas por minuto por endpoint como cualquier otra llamada de esa cuenta.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el