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.

  • hashtag admite un nombre, un enlace /tag/ o un ID numérico
  • Devuelve los totales, no los videos de la etiqueta
  • Un hashtag con announcement devuelve el aviso de la parte superior de su página

Salud de la API

Salud 24 h
Normal
  • Saludable / normal
  • Disponible
Normal

Últimas 24 horas

Últimos 30 días

  1. 1Solicitud

    POST /api/v1/social
    {
      "platform": "tiktok",
      "action": "hashtag_detail",
      "params": {
        "hashtag": "fyp"
      }
    }
  2. 2Respuesta JSON

    {
      "results": {
        "hashtag_id": "229207",
        "hashtag_name": "fyp",
        "video_count": 9551698607,
        "view_count": 132213607992265,
        …
      }
    }
  3. 3Campos

    hashtag_idhashtag_namevideo_countview_count
    229207fyp9551698607132213607992265
  4. 4CSV

    tiktok-hashtag_detail-sample.csv hashtag_id,hashtag_name,url,description,video_count,view_count,cover_image_url,is_commercial,announcement,platform

La solicitud lleva 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_idhashtag_nameurldescriptionvideo_countview_countcover_image_urlis_commercialannouncementplatform
229207fyphttps://www.tiktok.com/tag/fypnull9551698607132213607992265nullnullnulltiktok

Casos de uso

  • Registra el tamaño de una etiqueta con el tiempo

    Lee video_count y view_count a intervalos fijos y resta para ver el cambio.

  • Guarda el resumen y la portada de la etiqueta

    description y cover_image_url solo llegan cuando la página del hashtag los tiene. Guárdalos con hashtag_id cuando los recibas.

  • Lee el aviso de la página de una etiqueta

    announcement es 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_id y registra por ID a partir de ahí.

Límites y detalles a tener en cuenta

  • hashtag es obligatorio: un nombre de hashtag (por ejemplo nasa, con o sin #), un enlace como https://www.tiktok.com/tag/<nombre> o un ID numérico de hashtag.
  • Una llamada lee un hashtag y devuelve un objeto.
  • description, announcement y cover_image_url solo 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.

LlamadasCosto
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

#
bash
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.

POST

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

#
NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-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.
platformbodystringSítiktokIdentificador de la plataforma, valor fijo.
actionbodystringSíhashtag_detailIdentificador de la capacidad, valor fijo.
hashtagbody.paramsstringSí-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

#
Obtenida el 21 de noviembre de 2026, 07:21 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto). id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.
json
{  "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.

CampoSignificado
hashtag_idConserva el significado de la plataforma
hashtag_nameConserva el significado de la plataforma
urlEnlace al registro en la plataforma.
descriptionResumen o descripción, normalmente más breve que text.
video_countConserva el significado de la plataforma
view_countVisualizaciones o reproducciones. null significa no publicado, no 0.
cover_image_urlConserva el significado de la plataforma
is_commercialConserva el significado de la plataforma
announcementConserva el significado de la plataforma
platformIdentificador 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.

Errores

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.

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.

Google Analytics solo si aceptas. Privacidad