API de Detalles del hashtag de TikTok
Lee los detalles de un hashtag de TikTok a partir de su nombre, enlace o ID numérico en hashtag: hashtag_id, video_count, view_count e is_commercial, por $0.56 por cada 1000 llamadas.
hashtagadmite un nombre, un enlace/tag/o un ID numérico- Devuelve los totales, no los videos de la etiqueta
- Un hashtag con
announcementdevuelve el aviso de la parte superior de su página
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": "hashtag_detail", "params": { "hashtag": "fyp" } }2Respuesta JSON
{ "results": { "hashtag_id": "229207", "hashtag_name": "fyp", "video_count": 9551698607, "view_count": 132213607992265, … } }3Campos
hashtag_id hashtag_name video_count view_count 229207 fyp 9551698607 132213607992265 4CSV
tiktok-hashtag_detail-sample.csv hashtag_id,hashtag_name,url,description,video_count,view_count,cover_image_url,is_commercial,announcement,platform
hashtag y devuelve un objeto JSON con hashtag_id, video_count, view_count y más, listo como tabla de campos o CSV.Qué datos obtienes
La tabla muestra una llamada real para fyp, capturada el 21 de noviembre de 2026, 07:21 (UTC), que devolvió un objeto. Tus llamadas devuelven los campos de la referencia de campos.
| hashtag_id | hashtag_name | url | description | video_count | view_count | cover_image_url | is_commercial | announcement | platform |
|---|---|---|---|---|---|---|---|---|---|
| 229207 | fyp | https://www.tiktok.com/tag/fyp | null | 9551698607 | 132213607992265 | null | null | null | tiktok |
Casos de uso
Registra el tamaño de una etiqueta con el tiempo
Lee
video_countyview_counta intervalos fijos y resta para ver el cambio.Guarda el resumen y la portada de la etiqueta
descriptionycover_image_urlsolo llegan cuando la página del hashtag los tiene. Guárdalos conhashtag_idcuando los recibas.Lee el aviso de la página de una etiqueta
announcementes el aviso de la parte superior de la página del hashtag. Solo se devuelve cuando la etiqueta lo tiene.Convierte el nombre de una etiqueta en un ID
Lee la etiqueta una vez por nombre o enlace, guarda el
hashtag_idy registra por ID a partir de ahí.
Límites y detalles a tener en cuenta
hashtages obligatorio: un nombre de hashtag (por ejemplo nasa, con o sin #), un enlace comohttps://www.tiktok.com/tag/<nombre>o un ID numérico de hashtag.- Una llamada lee un hashtag y devuelve un objeto.
description,announcementycover_image_urlsolo se devuelven cuando la página del hashtag los tiene.- Esta página lee los totales del hashtag, no los videos de la etiqueta. Para los videos usa
hashtag.
Precios
Cada llamada cuesta $0.000556 y una llamada lee un hashtag. 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 usan 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": "hashtag_detail",
"params": {
"hashtag": "fyp"
}
}'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 hashtag_detail, y copia la página o ábrela como Markdown para un asistente de IA.
Prompt para IA
#Ayúdame a escribir un script de recopilación de datos con el endpoint de EveryInfra TikTok: Detalles del hashtag (tiktok/hashtag_detail).
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 hashtag_detail, y los parámetros dentro de params.
- Parámetros obligatorios:
- hashtag: Un nombre de hashtag como nasa (se quita la # inicial), un enlace https://www.tiktok.com/tag/<nombre> o un ID numérico.
- Devuelve un objeto. Campos principales: hashtag_id, hashtag_name, url, description, video_count, view_count, cover_image_url, is_commercial, announcement.
- Cuerpo de solicitud de ejemplo:
{
"platform": "tiktok",
"action": "hashtag_detail",
"params": {
"hashtag": "fyp"
}
}
- 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í | hashtag_detail | Identificador de la capacidad, valor fijo. |
hashtag | body.params | string | Sí | - | Un nombre de hashtag como nasa (se quita la # inicial), un enlace https://www.tiktok.com/tag/<nombre> o un ID numérico. |
Ejemplo de respuesta
#{ "id": "req_…", "platform": "tiktok", "action": "hashtag_detail", "results": { "hashtag_id": "229207", "hashtag_name": "fyp", "url": "https://www.tiktok.com/tag/fyp", "video_count": 9551698607, "view_count": 132213607992265, "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 |
|---|---|
hashtag_id | Conserva el significado de la plataforma |
hashtag_name | Conserva el significado de la plataforma |
url | Enlace al registro en la plataforma. |
description | Resumen o descripción, normalmente más breve que text. |
video_count | Conserva el significado de la plataforma |
view_count | Visualizaciones o reproducciones. null significa no publicado, no 0. |
cover_image_url | Conserva el significado de la plataforma |
is_commercial | Conserva el significado de la plataforma |
announcement | Conserva el significado de 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 detalles de hashtag de TikTok?
Un objeto: hashtag_id, hashtag_name, url, video_count, view_count e is_commercial. Cuando la página del hashtag los tiene, también devuelve description, announcement y cover_image_url.
¿Cuánto cuesta leer un hashtag?
Cuesta $0.000556 por llamada, o $0.56 por cada 1000 llamadas. Una llamada lee un hashtag. Las llamadas fallidas y los resultados vacíos no se cobran.
¿Qué puedo poner en hashtag?
Un nombre de hashtag, con o sin #, un enlace como https://www.tiktok.com/tag/<nombre> o un ID numérico de hashtag.
¿En qué se diferencian hashtag_detail, hashtag_search y hashtag?
hashtag_detail lee los totales de un hashtag conocido, hashtag_search encuentra hashtags por palabra clave y hashtag lee los videos de un hashtag.
Capacidades de TikTok relacionadas
La misma clave sirve para las demás capacidades de TikTok, por ejemplo hashtag para los videos de este hashtag, o hashtag_search para encontrar hashtags parecidos.
- 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. - Reconocimiento de enlaces
resolve_links$0.56 por cada 1000 llamadasLee el ID del video de un enlace de TikTok enurl, incluidos los enlaces cortos de vm.tiktok.com y vt.tiktok.com. - 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.