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ámetros | Obligatorio | Descripción |
|---|---|---|
hashtags | Obligatorio | Uno o más hashtags no vacíos. El # inicial es opcional y se elimina antes de la recopilación. |
results_limit | Opcional | Cantidad máxima de videos que se recopilan por hashtag, de 20 a 2,000; el valor predeterminado es 100. |
content_type | Opcional | Modo 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.
- Prepare uno o más hashtags no vacíos, con o sin el # inicial, y seleccione all o shorts.
- Envíe hashtags, results_limit y content_type por POST a /v1/youtube/hashtag-search.
- Guarde el task_id devuelto y consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o falle.
- 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 trueCasos 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.
APIs relacionadas
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.
- YouTube Channel Videos API
- YouTube Transcripts API
- YouTube Channels API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API