tiktok-creative-center/
trending-hashtag-detail

Consulte un hashtag en tendencia de TikTok por su ID de Creative Center: cantidad de publicaciones y de vistas, una curva diaria de popularidad, los países principales por puntuación y los ID de videos de ejemplo.

TikTok Creative Center Hashtag Insights API

ID del hashtag
Países principales
Videos de ejemplo
0.5 créditos por solicitud
Listo
README

Por SocQ · Actualizado el

TikTok Creative Center Hashtag Insights

El detalle de un hashtag en Creative Center perfila una etiqueta en tendencia dentro de un mercado: su cantidad de publicaciones y de vistas, una curva diaria de popularidad, los países donde es más popular en relación con su tamaño y videos de ejemplo que la usan. En conjunto muestran cómo se mueve una tendencia, en qué otros lugares tiene eco y qué tipo de contenido la sostiene.

Funcionalidades de la TikTok Creative Center Hashtag Insights API

  • Una etiqueta, consultada por IDhashtag_id recibe el id de un resultado de Trending Hashtags y devuelve un único registro de esa etiqueta en el country y el time_range elegidos.
  • Curva y conteos de la ventanapopularity_curve entrega un valor con fecha por día, de 0 a 100, con metrics.posts_count y metrics.views_count a su lado.
  • Países clasificados por puntuacióntop_countries enumera country_code y score, de mayor a menor, donde la puntuación refleja la popularidad en relación con el tamaño del país.
  • ID de videos de ejemplovideo_ids enumera videos que usan la etiqueta y muestra sobre qué contenido se apoya la tendencia.

Parámetros de la TikTok Creative Center Hashtag Insights API

ParámetrosObligatorioDescripción
hashtag_idObligatorioID de un hashtag de un resultado de TikTok Creative Center Trending Hashtags.
countryOpcionalCódigo de país de dos letras del mercado, como US, GB o JP. El valor predeterminado es US.
time_rangeOpcionalPeriodo que se analiza: 7d (predeterminado), 30d o 90d.

Cómo usar la TikTok Creative Center Hashtag Insights API

Tome el ID de un hashtag de la clasificación en tendencia y lea su detalle.

  1. Obtenga hashtags con TikTok Creative Center Trending Hashtags y copie un id.
  2. Envíe {"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"} por POST a /v1/tiktok-creative-center/trending-hashtag-detail.
  3. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded y lea el único registro en results.items.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtag_id":"7155204034885287979","country":"US","time_range":"7d"}'

# top_countries lists {country_code, score}; video_ids lists example videos.

Casos de uso de la TikTok Creative Center Hashtag Insights API

  • Decidir si vale la pena sumarse a una tendencia: Lea popularity_curve y los conteos de metrics antes de comprometer una campaña con una etiqueta, y compruebe si la curva sigue subiendo en su último día.
  • Evaluar mercados para expandirse: Use top_countries para ver qué otros países puntúan más alto en una etiqueta que es tendencia en su país, y prepare una lista corta para publicaciones localizadas.

Consejos de expertos para la TikTok Creative Center Hashtag Insights API

  • Envíe el mismo country y time_range de la clasificación de la que salió el id, para que las cifras describan la lista en la que eligió la etiqueta.
  • No lea top_countries como una clasificación por volumen: la puntuación es relativa al tamaño del país, así que un mercado pequeño puede quedar por encima de uno grande.

Además de la TikTok Creative Center Hashtag Insights API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok Creative Center.

Explorar otras plataformas

Combine los datos de TikTok Creative Center con datos públicos de otras plataformas sociales compatibles.

TikTok Creative Center Hashtag Insights API — FAQ

TikTok Creative Center Hashtag Insights API es una interfaz programática para obtener el detalle de un hashtag en tendencia de TikTok, identificado por su ID de Creative Center, el país y el periodo. Devuelve las cantidades de publicaciones y de vistas, una curva diaria de popularidad, los países principales por puntuación y los ID de videos de ejemplo.

Del campo id de un resultado de Trending Hashtags, tomado de la clasificación del país que va a consultar. Es una cadena numérica de 5 a 32 dígitos, y cualquier otro formato se rechaza con un error 400.

Aquí no, porque este endpoint acepta solo el ID numérico. Para obtener la cantidad de videos y las vistas totales de una etiqueta por su nombre, use TikTok Hashtag Views API.

top_countries y video_ids, que son null en las filas de la clasificación. rank es null aquí porque una posición pertenece a la clasificación, así que conserve el rank del resultado de Trending Hashtags.

Mide qué tan popular es el hashtag en ese país en relación con el tamaño del país, y la lista va ordenada de la puntuación más alta a la más baja. Por eso un mercado pequeño puede superar a uno grande.

La tarea falla con reembolso completo. Una solicitud exitosa se factura una sola vez a 0.5 créditos, sin importar cuántos video_ids se devuelvan.