Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

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.

40 QPM

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.

1,000 QPM

Presupuesto para todos los endpoints de la API de Accounts combinados por app de desarrollador en Advanced, Premium y Ultimate; Basic recibe 600.

50 QPS

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.

HTTP 200

Estado que TikTok devuelve junto con sus códigos de retorno, incluidos los 4xxxx como 40100; solo el código 0 significa éxito.

10 QPS

Límite de tasa para cada endpoint de la API de Discovery por app de desarrollador.

00:00 UTC

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:

Per account and endpoint40 queries a minute for each authorized TikTok account on each Accounts API endpoint
Per app, Accounts API combined600 queries a minute at Basic, and 1,000 at Advanced, Premium and Ultimate
Per app and endpointQueries a second, a minute and a day, set by the app's level
PublishingSix posts a minute and 15 a day per account, on the video and on the photo endpoint
Mentions APIThe app's global limits, with TikTok advising one call per endpoint and account a day
Discovery API10 queries a second on each endpoint, per developer app

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

Basic10 a second, 600 a minute, 864,000 a day; Accounts API combined: 600 a minute
Advanced20 a second, 1,200 a minute, 1,728,000 a day; Accounts API combined: 1,000 a minute
Premium30 a second, 1,800 a minute, 2,592,000 a day; Accounts API combined: 1,000 a minute
Ultimate50 a second, 3,000 a minute, 4,320,000 a day; Accounts API combined: 1,000 a minute

¿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.
Hacerlo con EasyCoexistence

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