youtube/
hashtag-search

Encuentre videos públicos de YouTube por uno o más hashtags, con títulos, identidad del canal, miniaturas, duración, interacción y contexto del hashtag de origen en registros normalizados.

YouTube Hashtag Search API

Feeds de hashtags
Filtro de Shorts
Hashtags de origen
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

YouTube Hashtag Search

Los feeds de hashtags de YouTube son colecciones públicas de videos asociadas a una etiqueta temática, con títulos, descripciones, identidad del canal, miniaturas, duración, datos de publicación e interacción visible. Estos registros sirven para mapear temas, revisar la participación en campañas, muestrear Shorts y analizar contenido de forma comparativa.

Funcionalidades de la YouTube Hashtag Search API

  • Descubrimiento en feeds de hashtagsEncuentra videos públicos asociados a un hashtag sin necesidad de proporcionar URL de videos ni de canales.
  • Modos de todo el contenido y de ShortsPermite definir content_type como all para el feed de hashtag expuesto o como shorts para una muestra solo de Shorts.
  • Contexto del video y del canalDevuelve títulos, descripciones, identidad del canal, miniaturas, duración, datos de publicación y el número visible de vistas, Me gusta y comentarios.
  • Hashtag de origen conservadoCada registro guardado incluye el hashtag de origen normalizado que se conservó para ese resultado de video.

Parámetros de la YouTube Hashtag Search API

ParámetrosObligatorioDescripción
hashtagsObligatorioUno o más hashtags no vacíos. El # inicial es opcional y se elimina antes de la recopilación.
results_limitOpcionalCantidad máxima de videos que se recopilan por hashtag, de 20 a 2,000; el valor predeterminado es 100.
content_typeOpcionalModo de contenido: all para el feed de hashtag expuesto o shorts para resultados solo de Shorts; el valor predeterminado es all.

Cómo usar la YouTube Hashtag Search API

Elija las etiquetas que representen los límites temáticos que desea inspeccionar y mantenga constantes el modo de contenido y el límite por etiqueta cuando necesite comparar muestras.

  1. Prepare uno o más hashtags no vacíos, con o sin el # inicial, y seleccione all o shorts.
  2. Envíe hashtags, results_limit y content_type por POST a /v1/youtube/hashtag-search.
  3. Guarde el task_id devuelto y consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o falle.
  4. Lea los videos normalizados en data.results.items y continúe con next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/hashtag-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["#technology"],"results_limit":20,"content_type":"shorts"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la YouTube Hashtag Search API

  • Revisión de la participación en campañas: Use muestras de feeds de hashtags, descripciones de videos, identidad de los canales e interacción visible para revisar la participación pública en una campaña.
  • Muestreo de temas en Shorts: Seleccione shorts para armar una muestra enfocada de videos de formato corto asociados a una etiqueta temática.
  • Preparación de conjuntos de datos temáticos: Combine IDs de videos, URL, datos de publicación, contexto de los canales, métricas y hashtags de origen conservados en conjuntos de datos de investigación estructurados.

Consejos de expertos para la YouTube Hashtag Search API

  • Normalice su lista de entrada antes del envío para que #technology y technology no generen trabajo de recopilación duplicado.
  • Use un hashtag por tarea cuando importe la atribución entre feeds que se superponen, porque los IDs de video duplicados se guardan una sola vez y conservan un solo hashtag de origen.
  • Trate results_limit como un tope por hashtag; la recopilación puede detenerse antes si el feed termina o expone menos videos elegibles.
  • Mantenga separadas las muestras de all y de shorts al comparar formatos, para que un feed mixto no distorsione el subconjunto de formato corto.
  • Almacene las URL de miniaturas y de origen como referencias en lugar de suponer que son descargas de medios permanentes.

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

  • YouTube Comments API — Recolecta comentarios públicos, autores, interacción, videos de origen y contexto de la conversación.
  • YouTube Videos API — Obtiene metadatos, miniaturas, duración e interacción desde URLs conocidas de videos o Shorts.
  • YouTube Shorts API — Recolecta Shorts públicos por canal, con miniaturas, duración, datos de publicación e interacción.
  • YouTube Search API — Busca videos públicos regulares por palabra clave con filtros de metadatos compatibles.
  • YouTube Channel Search API — Encuentra canales por palabra clave, con nombres, número de suscriptores, avatares y fragmentos de la descripción.
  • YouTube Shorts Search API — Busca Shorts por palabra clave, con enlaces, descripciones, número de vistas y miniaturas verticales.

Explorar otras plataformas

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

YouTube Hashtag Search API — FAQ

YouTube Hashtag Search API es una interfaz programática que encuentra videos públicos asociados a uno o más hashtags. Devuelve campos normalizados de video y canal, miniaturas, duración, datos de publicación, interacción visible y un hashtag de origen conservado.

Envíe una lista no vacía de cadenas como technology o #technology. El # inicial es opcional y se elimina antes de la recopilación.

Sí. Defina content_type como shorts para obtener resultados solo de Shorts, o deje el modo predeterminado all para el feed de hashtag expuesto.

results_limit se aplica por separado a cada hashtag enviado, tiene un valor predeterminado de 100 y acepta enteros de 20 a 2,000. El feed expuesto o el tope de recopilación de 100 páginas pueden producir menos registros.

Los IDs o URL de videos repetidos se guardan una sola vez dentro de una tarea. Si importa la atribución exacta al feed, envíe los hashtags en tareas separadas, porque un registro guardado conserva un solo hashtag de origen.

Cada video normalizado guardado cuesta 0.5 créditos, sin cargo base. La estimación de la solicitud multiplica results_limit, o su valor predeterminado de 100, por la cantidad de hashtags; el uso final sigue la cantidad real de registros guardados, y un conjunto de resultados vacío no genera cargo por resultado.