Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

URL de medios de TikTok: dominios y prefijos de URL verificados

La API for Business de TikTok descarga los medios de las publicaciones desde URL: video_url, custom_thumbnail_url y photo_images. Cada URL debe estar en un dominio o prefijo de URL cuya propiedad la app de desarrollador haya verificado. Un dominio se verifica con un registro DNS TXT y un prefijo con un archivo de firma colocado bajo él, mediante /business/property/add/ y /business/property/verify/ con el ID de la app y su secret.

easyCoexistence sirve tus medios a TikTok desde su propio prefijo de URL verificado: publish_tiktok_post acepta un enlace HTTPS de Claude, ChatGPT o tu propio código y transmite el archivo desde él cuando TikTok lo descarga, así que tu dominio no necesita verificación.

Nov 16, 2023

Desde entonces, TikTok rechaza las URL de video que no estén en un dominio o prefijo de URL verificado.

Oct 15, 2025

Desde entonces, los endpoints de propiedades de URL también exigen el secret de la app de desarrollador.

1 / 2

Valores de property_type: 1 para un dominio, 2 para un prefijo de URL.

0, 1, 2

Valores de property_status: pending, verified y not verified, este último cuando el intento falló y hay que repetirlo.

Apr 7, 2023

Los desarrolladores que publicaron videos antes de esa fecha tienen los dominios de esas URL de video configurados como verificados automáticamente.

5 MB

El tamaño máximo de imagen que acepta /business/comment/image/upload/, como datos de formulario multiparte, para un comentario o una respuesta.

¿Qué URL descarga TikTok?

Cada campo de medios de los dos endpoints de publicación es una URL que TikTok obtiene por sí mismo tras aceptar la llamada, así que el archivo debe seguir accesible hasta que termine la descarga:

  • video_url: el video, que TikTok recomienda mantener válido al menos 30 minutos.
  • custom_thumbnail_url: una imagen que se usa como portada del video.
  • photo_images: hasta 35 imágenes para una publicación de fotos.
  • Tiempo de espera: TikTok da una hora a la descarga y, después, la publicación falla con video_pull_failed o photo_pull_failed.

¿Cuál es la diferencia entre un dominio y un prefijo de URL?

Lo que demuestras que posees y, por tanto, qué URL cuentan como verificadas. Un dominio sirve para medios en un host que posees o controlas; un prefijo sirve para una carpeta en un host donde solo puedes subir archivos. Estas son las reglas de TikTok para cada tipo de propiedad:

DomainURL prefix
What it isA site you own, such as example.com or a subdomainhttps:// plus a host, a path and a final /, such as https://www.example.com/videos/
ProofA DNS TXT record holding the signatureA file named file_name, holding the signature, uploaded under the prefix
CoversURLs on the domain and its subdomainsURLs that begin with the prefix
Leaves outThe parent: verifying video.example.com leaves example.com unverifiedSibling paths: /folder/user/ leaves /folder/public/ unverified
RedirectsNot applicableNot followed; a prefix answering 3xx is invalid

¿Cómo se verifica una propiedad?

Mediante dos llamadas que se autentican con el app_id y el secret de la app de desarrollador en lugar de un token de cuenta, con la prueba colocada entre ambas:

  • Alta: POST /business/property/add/ con url_property_meta, que contiene property_type y url; la respuesta devuelve signature, además de file_name para un prefijo, con property_status 0.
  • Demostración: coloca la firma en un registro DNS TXT para un dominio, o en un archivo público llamado file_name, con una única extensión .txt, bajo un prefijo.
  • Verificación: POST /business/property/verify/ con el mismo url_property_meta; property_status 1 significa verificada y 2 significa que el intento falló.
Add a URL prefix
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/property/add/' \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "<APP_ID>",
    "secret": "<APP_SECRET>",
    "url_property_meta": { "property_type": 2, "url": "https://media.example.com/tiktok/" }
  }'

# data.url_property_info: url, property_type, property_status (0), signature, file_name

¿Cómo se listan o eliminan propiedades?

GET /business/property/list/ con app_id y secret devuelve url_property_info_list, con cada entrada que incluye property_type, url, property_status, signature y file_name. Los subdominios de un dominio verificado cuentan como verificados sin una llamada propia, pero aparecen en el listado solo si se añadieron. POST /business/property/delete/ con app_id, secret y url_property_meta elimina una propiedad que la app ya no posee ni controla.

¿Puedes subir un archivo en lugar de una URL?

No para publicaciones. La Accounts API publica solo desde URL, incluidos los borradores, y su único endpoint de carga, /business/comment/image/upload/, recibe una imagen de comentario como datos de formulario multiparte, en JPG, JPEG, WebP o PNG de hasta 5 MB, y devuelve un image_uri para un comentario o una respuesta. La carga de archivos por fragmentos corresponde a la Content Posting API en developers.tiktok.com, una API distinta con sus propias apps, donde el método de transferencia se llama FILE_UPLOAD.

¿Qué pasa con una URL que no está verificada?

TikTok se niega a publicar desde ella. La referencia de la API for Business establece la regla para videos y fotos, pero no define un código de respuesta propio para este caso, así que lee el código y el mensaje de la respuesta. La Content Posting API en developers.tiktok.com llama al mismo caso url_ownership_unverified, con HTTP 403. Para probar el endpoint de video antes de verificar ninguna propiedad, TikTok publica una URL de video de prueba que no necesita verificación:

TikTok's test video URL for /business/video/publish/
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4

¿Cómo easyCoexistence lleva tus medios a TikTok?

A través de un prefijo de URL verificado propio, https://easycoexistence.com/api/social/media/. publish_tiktok_post acepta tu enlace HTTPS, rechaza http:// antes de enviar nada y entrega a TikTok un enlace bajo ese prefijo, con un token firmado que identifica tu archivo, caduca a las 6 horas y conserva la extensión del archivo. Cuando TikTok lo obtiene, easyCoexistence verifica el token, confirma que tu enlace usa HTTPS en una dirección pública y transmite el archivo directamente desde tu enlace, incluidas las peticiones de rango y las redirecciones, sin almacenarlo. Si tu enlace falla, TikTok no puede descargar el archivo y la publicación falla.

What TikTok receives in place of your link
Your link:       https://cdn.example.com/videos/launch.mp4
Sent to TikTok:  https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4

Errores comunes

  • Verificar un subdominio y alojar los archivos en su dominio padre. Un video.example.com verificado cubre sus propios subdominios, no example.com en sí.
  • Servir el archivo de firma del prefijo mediante una redirección. TikTok no sigue redirecciones para un prefijo de URL y trata una respuesta 3xx como inválida.
  • Guardar el archivo de firma como name.txt.txt. TikTok espera que el nombre coincida con file_name, con una única extensión .txt.
  • Borrar el archivo justo después de la llamada de publicación. TikTok lo descarga después, durante hasta una hora, y la publicación falla si el enlace deja de funcionar.
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

¿Por qué TikTok exige URL de medios verificadas?

TikTok dice que verificar la propiedad de las URL de video le ayuda a cumplir sus políticas sobre contenido protegido por derechos de autor y seguridad de los usuarios.

¿Un dominio de TikTok verificado cubre sus subdominios?

Sí. Los subdominios de un dominio verificado cuentan como verificados, aunque /business/property/list/ solo los muestra si se añadieron.

¿La API for Business de TikTok puede publicar desde un enlace de S3 o CDN?

Sí, cuando el enlace está bajo un dominio o prefijo de URL que la app ha verificado, como un prefijo en un bucket o una ruta de CDN que controlas.

¿Las publicaciones de fotos también necesitan URL verificadas?

Sí. El endpoint de fotos de TikTok establece que las publicaciones de fotos no pueden publicarse desde URL de fotos no verificadas.

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