tiktok/
hashtag-detail

Consulte cuántos videos y cuántas vistas totales tienen hasta 20 hashtags de TikTok en una sola solicitud, con el ID y el enlace de la página de cada hashtag para compararlos lado a lado.

TikTok Hashtag Views API

Hasta 20 hashtags
Vistas totales
Cantidad de videos
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

TikTok Hashtag Views

La página de un hashtag de TikTok resume todos los videos públicos que usan la etiqueta en dos totales acumulados: cuántos videos la llevan y cuántas vistas han reunido. Leídos en conjunto indican qué tan grande y qué tan saturado está un tema, y las vistas por video dan una pista de cómo suele rendir el contenido bajo esa etiqueta.

Funcionalidades de la TikTok Hashtag Views API

  • Hasta 20 hashtags por solicitudEnvíe de 1 a 20 nombres, con o sin #, y reciba un registro por cada hashtag que exista.
  • Totales como números enterosmetrics.posts_count y metrics.views_count llegan como enteros simples y no como textos abreviados, de modo que se pueden ordenar y dividir directamente.
  • ID del hashtag y enlace de su páginaid contiene el ID numérico del hashtag en TikTok y url la página de la etiqueta, lo que da a cada registro una clave para relacionarlo entre ejecuciones.

Parámetros de la TikTok Hashtag Views API

ParámetrosObligatorioDescripción
hashtagsObligatorioDe uno a 20 nombres de hashtag, con o sin el prefijo #.

Cómo usar la TikTok Hashtag Views API

Envíe una lista de hashtags y lea un registro por etiqueta.

  1. Envíe {"hashtags": ["cooking", "booktok"]} por POST a /v1/tiktok/hashtag-detail.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. Lea name, metrics.posts_count y metrics.views_count de cada hashtag en results.items.
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["cooking","booktok"]}'

# metrics.posts_count is the video count; metrics.views_count is the total views.

Casos de uso de la TikTok Hashtag Views API

  • Elegir los hashtags de una campaña: Ponga las etiquetas candidatas en una sola solicitud y compare posts_count para medir la saturación y views_count para medir el alcance antes de decidirse por un conjunto.
  • Seguimiento de un hashtag de marca: Consulte la etiqueta de su campaña de forma periódica y grafique cómo suben su cantidad de videos y sus vistas totales después de cada impulso.
  • Medir el tamaño de un tema: Busque las etiquetas que definen un nicho, una tendencia o un asunto público y compare sus totales para ver dónde se concentra el contenido sobre ese tema.

Consejos de expertos para la TikTok Hashtag Views API

  • No sume views_count entre hashtags para dimensionar un tema, porque un video que lleva varios se cuenta en cada uno; compare las etiquetas lado a lado o tome la mayor.
  • Divida views_count entre posts_count solo cuando posts_count exista y sea mayor que cero, y luego ordene las etiquetas por vistas promedio por video para comparar tamaños muy distintos.
  • Guarde cada resultado con su hora collected_at cuando siga una etiqueta; cada solicitud devuelve los totales actuales, así que el crecimiento solo se ve si conserva las capturas anteriores.
  • Relacione los resultados con su lista de entrada por name o por id y no por posición, ya que un hashtag que no existe se omite y la salida puede ser más corta que la entrada.

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

  • TikTok Hashtags API — Recolecta videos públicos, creadores, contenido multimedia, sonido e interacción de los hashtags indicados.
  • TikTok Search API — Busca videos públicos por palabra clave con filtros de orden y de publicación compatibles.
  • TikTok Live Room Info API — Consulta una transmisión en vivo conocida mediante el par de IDs de la sala y del propietario, y devuelve su estado, el contexto del propietario, la portada y los conteos de audiencia.
  • TikTok Search Users API — Busca cuentas públicas de TikTok por palabra clave.
  • TikTok Top Search API — Busca por palabra clave videos y publicaciones de imágenes, con descripciones, creadores y conteos de interacción.
  • TikTok Trending Searches API — Obtiene las búsquedas en tendencia de hoy en TikTok, en orden de clasificación.

Explorar otras plataformas

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

TikTok Hashtag Views API — FAQ

TikTok Hashtag Views API es una interfaz programática para consultar por nombre los totales de hasta 20 hashtags de TikTok. Devuelve el ID de cada hashtag, la URL de su página, su cantidad de videos y sus vistas totales.

Envíe el nombre del hashtag y lea metrics.views_count para las vistas totales y metrics.posts_count para la cantidad de videos que usan la etiqueta. Ambas son cifras acumuladas del hashtag en conjunto.

La respuesta incluye metrics.views_count junto a metrics.posts_count para cada hashtag, y un contador que TikTok no informa para una etiqueta llega como null.

Hasta 20, escritos con o sin #. Cada hashtag existente devuelve su propio registro, así que una lista completa de candidatos se puede comparar con un solo resultado.

Se omite del resultado y no se cobra, mientras los demás hashtags de la solicitud sí se devuelven. Una solicitud en la que ninguno de los hashtags existe no cuesta nada.

El endpoint devuelve los totales actuales con una hora collected_at y sin historial. Ejecútelo de forma periódica y conserve cada captura para graficar el crecimiento.

No, solo los totales y los identificadores del hashtag. Para reunir los videos use TikTok Hashtags.

Por cada hashtag que existe, a 0.5 créditos. Una lista de 20 etiquetas existentes cuesta entonces 10 créditos, y una solicitud sin coincidencias no cuesta nada.