Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

TikTok API for Business: scopes y qué desbloquea cada permiso

La API for Business de TikTok concede acceso en dos capas. La app de desarrollador tiene permisos bajo TikTok Accounts, como Video Publish y Manage Account Comment, que abren endpoints. La autorización del titular de la cuenta da al token de acceso scopes, como user.insights y video.list, que determinan los campos devueltos. /tt_user/token_info/get/ enumera los scopes que lleva un token.

easyCoexistence pide al titular de la cuenta de TikTok los permisos que tiene su app en un solo inicio de sesión, para que Claude, ChatGPT o tu propio código puedan publicar, gestionar comentarios y leer métricas a través de sus herramientas, y get_social_credentials da a tu propio código el mismo token para otros endpoints de la Accounts API.

18000000

ID de scope de TikTok Accounts, el permiso de primer nivel por encima de los endpoints de perfil, publicaciones, comentarios y publicación de la Accounts API.

user.account.type

Scope detrás de is_business_account y has_advanced_access en los datos de perfil de una cuenta.

comment.list

Scope que el titular debe conceder y mantener activo para que la app reciba los eventos del webhook comment.update.

video.upload

Scope que necesita un token para subir una publicación como borrador en lugar de publicarla.

2 to 3 days

Días hábiles que puede tardar la revisión de TikTok de un cambio en los permisos de una app de desarrollador.

¿Cuáles son las dos capas de permisos de TikTok?

Permisos de app y scopes del token. Los permisos de app se eligen en My Apps, en la app, en Scope of permission, y TikTok los revisa; vienen en tres niveles, y un permiso de primer nivel cubre todos los endpoints inferiores. Los scopes del token son lo que el titular de la cuenta aprobó al autorizar la app, y se devuelven como scope, una cadena separada por comas, con cada token. Una llamada necesita el permiso de la app para su endpoint, y algunos campos de respuesta también requieren un scope en el token.

¿Qué permiso de app abre cada endpoint?

La referencia de la API de TikTok indica, para cada endpoint de la Accounts API, el permiso bajo TikTok Accounts que lo abre, o ninguno. Su referencia de scopes de permiso y su guía de webhooks llaman a los mismos grupos Business User, Business Media, Business Comment y Business Content, así que espera ver ambos conjuntos de nombres:

Account User/business/get/: profile data and account insights
Get Account Media/business/video/list/: the account's posts and their metrics
Video Publish/business/video/publish/, /business/publish/status/, /business/video/settings/, hashtag suggestions and location tags
Photo Publish/business/photo/publish/
Get Business Comment/business/comment/list/ and /business/comment/reply/list/
Manage Account CommentCreating, replying to, liking, hiding and deleting comments, and comment image uploads
Business Benchmark/business/benchmark/: benchmarks for a business category
No permission needed/tt_user/token_info/get/, the URL property endpoints and the webhook configuration endpoints

¿Qué scopes del token desbloquean qué campos?

Las referencias de TikTok para /business/get/ y /business/video/list/ indican un permiso requerido para cada campo de respuesta, y dos funciones más nombran un scope propio:

  • user.info.basic: display_name y profile_image.
  • user.info.username: username, que necesitó user.info.basic hasta junio de 2023.
  • user.info.profile: profile_deep_link, bio_description e is_verified.
  • user.info.stats: following_count, followers_count, total_likes y videos_count.
  • user.account.type: is_business_account y has_advanced_access.
  • user.insights: las métricas diarias de la cuenta y los desgloses de seguidores por edad, género, país y ciudad.
  • video.list: campos de publicaciones como item_id, caption, share_url, likes, comments, shares, reach y video_views.
  • video.insights: tiempo de visualización, tasa de visualización completa, retención, fuentes de tráfico, desgloses de espectadores y los clics que genera una publicación.
  • comment.list: el webhook comment.update, que TikTok describe como lectura de los comentarios y respuestas del contenido dentro de la app.
  • video.upload: subir una publicación de video o foto como borrador, con upload_to_draft o is_draft.

¿Cómo se ven los scopes de un token?

Consulta /tt_user/token_info/get/, que recibe el app_id y el token de acceso y devuelve el scope del token y el creator_id de la cuenta. Los ejemplos de cadenas de scope de TikTok también incluyen video.publish y comment.list.manage, cuyos nombres coinciden con los endpoints de publicación y de gestión de comentarios, aunque sus referencias no vinculan ningún campo con ninguno de ellos.

Read the scopes an access token carries
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
  -H 'Content-Type: application/json' \
  -d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "app_id": "<APP_ID>",
    "creator_id": "<OPEN_ID>",
    "scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
  }
}

¿Qué pide la conexión de TikTok de easyCoexistence?

Los permisos que mantiene su app de desarrollador, todos visibles en la página de consentimiento de TikTok. easyCoexistence envía al titular de la cuenta a la URL de autorización que genera el portal de TikTok para su app, la cual ya nombra esos permisos, y solo añade un valor state propio. El titular aprueba lo que muestra TikTok, y la cadena de scope que devuelve TikTok se guarda con la conexión. Los endpoints que easyCoexistence llama después para la cuenta:

  • /business/get/ para el perfil, las métricas diarias y los desgloses de seguidores.
  • /business/video/list/ para las publicaciones y sus métricas.
  • /business/video/publish/, /business/photo/publish/ y /business/publish/status/ para publicar.
  • /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ y /business/comment/delete/ para comentarios.
  • /business/webhook/update/, a nivel de app, para el webhook de comentarios.

¿Cómo se añade un permiso más adelante?

En dos pasos, uno por capa. Para la app, abre My Apps, la app, Scope of permission, edítalo, indica un motivo que coincida con los nuevos scopes y envíalo; la revisión de TikTok puede tardar de dos a tres días hábiles, y desde el 20 de marzo de 2026 una solicitud que incluya TikTok Accounts necesita primero el Accounts API Access Application Form. Para el token, el titular vuelve a autorizar la app, ya que un token conserva los scopes aprobados cuando se emitió.

¿Qué pasa cuando falta un permiso?

En una llamada, el código de retorno de TikTok es 40001, sin permiso para realizar la operación relacionada, y su solución remite a la referencia de scopes de permiso. En un campo, las referencias lo dejan disponible solo cuando el titular ha concedido su scope, y su solución es que el titular vuelva a autorizar la app con ese scope. Revisa el scope del token con /tt_user/token_info/get/ antes de preguntar.

Errores comunes

  • Esperar que las cuentas conectadas obtengan un nuevo permiso de app por sí solas. Sus tokens conservan los scopes aprobados en la autorización hasta que cada titular vuelva a autorizar la app.
  • Pedir is_business_account sin user.account.type. TikTok deja disponibles ese campo y has_advanced_access solo para tokens que llevan ese scope.
  • Esperar comment.update sin comment.list. TikTok envía eventos de comentarios solo mientras la autorización del titular con ese scope siga vigente.
  • Buscar en el token los nombres de permisos de app. La cadena de scope usa nombres como video.list, mientras que nombres como Get Account Media pertenecen a la configuración de la app.
Hacerlo con EasyCoexistence

De US$ 9 a US$ 0.75 por conexión al mes, con una baja a medida que añades conexiones, y los primeros 3 días gratis.

Preguntas frecuentes

¿Qué scopes usa la API for Business de TikTok?

Scopes de token como user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list y video.upload, concedidos por el titular de la cuenta además de los permisos TikTok Accounts de la app.

¿Qué permisos necesita el webhook de comentarios de TikTok?

La app necesita TikTok Accounts y Business Comment, y el titular debe conceder comment.list. Los eventos se detienen si esa autorización caduca o se revoca.

¿Un nuevo scope de TikTok se aplica a los tokens ya emitidos?

No. Un token conserva los scopes aprobados cuando se emitió, así que el titular vuelve a autorizar la app para añadir uno nuevo.

¿Cuánto tarda TikTok en aprobar un permiso nuevo?

TikTok indica que la revisión de un cambio de permisos puede tardar de dos a tres días hábiles, y las solicitudes que añaden TikTok Accounts necesitan primero el Accounts API Access Application Form.

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