API de Reconocimiento de enlaces de TikTok
Convierte un enlace de publicación de TikTok, incluidos los enlaces cortos para compartir como vm.tiktok.com y vt.tiktok.com, en el id de la publicación, la url canónica y el nombre de usuario del autor author_username, a $0.56 por cada 1000 llamadas.
- Se aceptan enlaces completos, enlaces /photo/ y enlaces cortos para compartir
- Un enlace por llamada
- Las llamadas fallidas y los resultados vacíos no se cobran.
Salud de la API
- Salud 24 h
- Normal
- Saludable / normal
- Disponible
Últimas 24 horas
Últimos 30 días
1Solicitud
POST /api/v1/social { "platform": "tiktok", "action": "resolve_links", "params": { "url": "https://www.tiktok.com/@stoolpresidente/video/7488736374602927402" } }2Respuesta JSON
{ "results": { … } }3Campos
4CSV
tiktok-resolve_links-sample.csv id,url,platform
url y sale un objeto JSON: id, url y author_username, que se muestra como tabla de campos y se puede descargar en CSV.Qué datos obtienes
La tabla muestra una llamada real para tiktok.com/@stoolpresidente/video/7488736374602927402, obtenida el 22 de noviembre de 2026, 06:29 (UTC), que devolvió un objeto. En tus llamadas recibes estos campos, tal como figuran en la referencia de campos.
| id | url | platform |
|---|---|---|
| 7488736374602927402 | https://www.tiktok.com/@/video/7488736374602927402 | tiktok |
Casos de uso
Expandir un enlace corto para compartir
Pasa un enlace corto vm.tiktok.com o vt.tiktok.com y lee
urlpara obtener el enlace canónico.Eliminar duplicados por ID de publicación
Los enlaces escritos de formas distintas que dan el mismo
idapuntan a la misma publicación, así que puedes eliminar duplicados porid.Obtener el nombre de usuario del autor
Lee
author_usernamey pásalo aprofileouser_videos.Limpiar un lote de enlaces
Cada llamada acepta un enlace, así que llama una vez por enlace y guarda
idyurlcomo dos columnas.
TikTok for Developers frente a EveryInfra
Así se comparan la documentación para desarrolladores de TikTok sobre oEmbed y resolve_links de EveryInfra en lo que da un enlace.
| Aspecto | TikTok for Developers | EveryInfra |
|---|---|---|
| De un enlace a datos del video | "Programmatically, you may convert a TikTok's video URL into embedded video markup by using the oEmbed API." | url acepta un enlace de publicación y devuelve el id de la publicación, la url canónica y el nombre de usuario del autor author_username. |
| Qué se devuelve | "It allows you to get the embed code and additional information about the video associated with the webpage link provided." | También parte de un enlace, y lo que devuelve es el ID de la publicación y el nombre de usuario del autor, no un código de inserción. |
Las citas proceden de la página Embedding TikTok Videos de TikTok for Developers. La página no muestra fecha de actualización y la cotejamos el 2026-11-22. Su ejemplo usa un enlace de video completo y no trata los enlaces cortos para compartir. Fuentes oficiales: Embedding TikTok Videos: A Comprehensive Guide
Límites y detalles a tener en cuenta
urles obligatorio, uno por llamada: un enlace completo https://www.tiktok.com/@usuario/video/<dígitos> (y /photo/<dígitos> para publicaciones de fotos) o un enlace corto para compartir como vm.tiktok.com o vt.tiktok.com.- La respuesta es un objeto con solo
id,urlyauthor_username. No trae texto ni reproducciones. Para leer el video, usavideo. ides el ID de la publicación,urles el enlace canónico yauthor_usernamees el nombre de usuario del autor.
Precios
Pagas $0.000556 por llamada. Cada llamada lee un resultado. Las llamadas fallidas y los resultados vacíos no se cobran.
| Llamadas | Costo |
|---|---|
| 10,000 | $5.56 |
| 100,000 | $55.56 |
| 1,000,000 | $555.56 |
Los totales se calculan con el precio de lista por llamada.
Ejemplos de código
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "tiktok",
"action": "resolve_links",
"params": {
"url": "https://www.tiktok.com/@stoolpresidente/video/7488736374602927402"
}
}'Definición OpenAPI (JSON)Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.
Referencia de API
Consulta los parámetros, los campos de respuesta, los errores y la facturación de resolve_links, y copia la página o ábrela en Markdown para dársela a un asistente de IA.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra TikTok: Reconocimiento de enlaces (tiktok/resolve_links).
Cómo funciona el endpoint:
- Solicitud: POST https://api.everyinfra.com/api/v1/social con la cabecera Authorization: Bearer <clave API>. Lee la clave de la variable de entorno EVERYINFRA_API_KEY y no la escribas en el código.
- En el cuerpo de la solicitud, pon platform en tiktok y action en resolve_links, y los parámetros dentro de params.
- Parámetros obligatorios:
- url: Un enlace de TikTok: un enlace completo de video o de foto (/video/ o /photo/), o un enlace corto vm.tiktok.com o vt.tiktok.com.
- Devuelve un objeto. Campos principales: id, url.
- Cuerpo de solicitud de ejemplo:
{
"platform": "tiktok",
"action": "resolve_links",
"params": {
"url": "https://www.tiktok.com/@stoolpresidente/video/7488736374602927402"
}
}
- Precio: $0.56 por 1.000 solicitudes; los resultados fallidos y vacíos no se cobran.
- Para decenas o cientos de objetivos, añade "mode": "async" al cuerpo: recibes un job_id al instante y consultas GET https://api.everyinfra.com/api/v1/jobs/{job_id} para obtener el resultado.
- Ante un 422, corrige la solicitud con los nombres de parámetros y los valores admitidos que sugiere el error; ante un 429 o un 503, espera lo que indique Retry-After y vuelve a intentarlo.
Antes de escribir código, pregúntame qué objetivos necesito, cuántos, qué campos y en qué formato quiero el resultado; luego confirma conmigo el plan y el coste aproximado.Parámetros de la solicitud
#| Nombre | Ubicación | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|---|
Authorization | header | string | Sí | - | Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código. |
platform | body | string | Sí | tiktok | Identificador de la plataforma, valor fijo. |
action | body | string | Sí | resolve_links | Identificador de la capacidad, valor fijo. |
url | body.params | string | Sí | - | Un enlace de TikTok: un enlace completo de video o de foto (/video/ o /photo/), o un enlace corto vm.tiktok.com o vt.tiktok.com. |
Ejemplo de respuesta
#{ "id": "req_…", "platform": "tiktok", "action": "resolve_links", "results": { "id": "7488736374602927402", "url": "https://www.tiktok.com/@/video/7488736374602927402", "platform": "tiktok" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campos de la respuesta
#Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la plataforma no muestra nunca se inventan.
| Campo | Significado |
|---|---|
id | Identificador único del registro en la plataforma. Solo es único dentro de una plataforma; puede repetirse entre plataformas. |
url | Enlace al registro en la plataforma. |
platform | Identificador de la plataforma, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok). |
Errores y facturación
#- 401
- Falta la clave o no es válida.
- 402
- Saldo insuficiente. Recarga primero.
- 422
- Nombre o valor de parámetro incorrecto. Corrígelo según las opciones indicadas en el error. Sin cargo.
- 429
- Se alcanzó el límite de solicitudes por minuto. Espera el tiempo indicado en Retry-After y vuelve a intentarlo.
- 503
- No se pudo completar. El cargo retenido vuelve a tu saldo. Si el resultado es incierto, compruébalo antes de reenviar.
- 200 vacío
- Sin datos. Sin cargo.
Preguntas frecuentes
¿Qué devuelve la API de reconocimiento de enlaces?
Un objeto: id (el ID de la publicación), url (el enlace canónico) y author_username (el nombre de usuario del autor).
¿Qué puedo hacer cuando ya tengo el enlace canónico?
Pasa url a video para los detalles, a comments para los comentarios o a video_download para el enlace de descarga.
¿Cuánto cuesta reconocer un enlace?
Cuesta $0.000556 por llamada, o $0.56 por cada 1000 llamadas. Cada llamada lee un resultado. Las llamadas fallidas y los resultados vacíos no se cobran.
Capacidades de TikTok relacionadas
Con la misma clave de API de EveryInfra puedes llamar a los demás endpoints de TikTok, por ejemplo video.
- Búsqueda
search$0.56 por cada 1000 llamadasBusca en TikTok mediantekeywordy elige la pestaña concontent_type: videos, cuentas o la vista general. - Detalles
profile$0.56 por cada 1000 llamadasResuelve unusernamede TikTok y devuelve biografía, enlace externo, seguidores, seguidos, likes, número de videos y fecha de creación. - Videos del usuario
user_videos$0.56 por cada 1000 llamadasObtiene videos públicos delusernamey permite filtrar por likes mínimos (min_likes), fijar una fecha máxima de publicación (until) u ordenar consort. - Detalles del video
video$0.56 por cada 1000 llamadasAbre laurlde un video de TikTok y recoge texto, autor, fecha y contadores de likes, comentarios, compartidos y vistas. - Comentarios
comments$0.56 por cada 1000 llamadasLee comentarios de laurldel video y distingue respuestas, fijado y reacción del autor cuando existen. - Contenido por hashtag
hashtag$0.56 por cada 1000 llamadasBusca videos publicados bajo elhashtagindicado, con o sin#, conservando autor y métricas por publicación. - Seguidores
followers$0.56 por cada 1000 llamadasRecibeusernamey devuelve contadores y señales de conexión agregadas, conchannelcompatible. - Transcripción
transcript$0.56 por cada 1000 llamadasExtrae el texto disponible del video indicado porurl, con segmentos cuando existen. - Búsqueda de productos de la tienda
shop_search$0.56 por cada 1000 llamadasBusca productos de TikTok Shop mediantekeyword, con país y página opcionales. - Datos del creador de la tienda
shop_creator$0.56 por cada 1000 llamadasConsulta un creador de Shop medianteusernamey país opcional, devolviendo categorías y contadores públicos. - Búsqueda de hashtags
hashtag_search$0.81 por cada 1000 llamadasBusca hashtags de TikTok porkeyword. - Búsqueda de música
music_search$0.81 por cada 1000 llamadasBusca en la biblioteca de sonidos de TikTok porkeyword, como una canción o un artista. - Lista de éxitos musicales
music_chart$0.81 por cada 1000 llamadasLee una lista musical de TikTok:top50(por defecto) oviral50. - Búsqueda de cuentas
user_search$0.56 por cada 1000 llamadasBusca cuentas de TikTok porkeyword, en el orden de la búsqueda de TikTok. - Videos con un sonido
sound_videos$0.56 por cada 1000 llamadasLista los videos de TikTok que usan un sonido, a partir de sumusic_ido del enlace de la página del sonido. - Respuestas a comentarios
comment_replies$0.56 por cada 1000 llamadasLee las respuestas a un comentario de un video de TikTok, con laurldel video y eliddel comentario que devuelvecomments. - Más vendidos de la tienda
shop_hot_products$0.81 por cada 1000 llamadasLee la lista de más vendidos de TikTok Shop de un mercado: ID, JP, MX, MY (por defecto), PH, SG, TH o VN. - Productos de la tienda por categoría
shop_category_products$0.81 por cada 1000 llamadasLista productos de TikTok Shop de una categoría porcategory_id, como 601450 (belleza y cuidado personal), en el mercado elegido. - Cuentas seguidas
following$0.64 por cada 1000 llamadasLista las cuentas que sigue un usuario de TikTok, por su usuario. - Enlaces de descarga del video
video_download$0.64 por cada 1000 llamadasObtiene los enlaces de descarga de un video de TikTok sin marca de agua, a partir de suurl. - Sala en directo
live_room$0.81 por cada 1000 llamadasComprueba si una cuenta de TikTok está en directo ahora, por su usuario. - Productos de una tienda
shop_products$0.81 por cada 1000 llamadasLista los productos de una tienda de TikTok Shop a partir de sushop_ido del enlace de la tienda, en el mercado elegido. - Reseñas de un producto de la tienda
shop_product_reviews$0.76 por cada 1000 llamadasLee reseñas de compradores de un producto de TikTok Shop a partir de suproduct_ido enlace. - Hashtags en tendencia
trending_hashtags$0.81 por cada 1000 llamadasLee los hashtags en tendencia de TikTok en un mercado durante los últimos 7, 30 o 90 días, opcionalmente de un sector. - ID de usuario por nombre
resolve_user$0.56 por cada 1000 llamadasConvierte unusernamede TikTok (con o sin @), un enlace de perfil o unsec_uiden eluser_idnumérico de la cuenta, susec_uid, elusernameactual y elurldel perfil. - Detalles del hashtag
hashtag_detail$0.56 por cada 1000 llamadasConsulta un hashtag de TikTok a partir dehashtag(el nombre, con o sin #, un enlace de la etiqueta o el ID numérico):hashtag_id,hashtag_name,url,video_countyview_countexactos, eis_commercial. - Detalles de la música
music_detail$0.56 por cada 1000 llamadasConsulta un sonido de TikTok pormusic_ido enlace:title,author_name,album,duration_seconds, cuántos videos lo usan (use_count),is_original,is_copyrighted, un enlace de portada y un enlace de audio de muestra que caduca.