YouTube Shorts Search
Los resultados de búsqueda de Shorts son los videos verticales que YouTube posiciona para una palabra clave en su filtro de Shorts, cada uno con una descripción, un número de vistas y una miniatura de 9:16. Revisarlos en conjunto muestra qué ganchos y enfoques captan la atención sobre un tema y le da un conjunto de enlaces de Shorts para estudiar o seguir más a fondo.
Funcionalidades de la YouTube Shorts Search API
- Shorts y nada másLos resultados provienen de la búsqueda de Shorts de YouTube, así que los videos largos, los canales y las listas de reproducción quedan fuera de la lista.
- Descripción, vistas y miniaturatext es la descripción del Short, metrics.views_count se obtiene del conteo que se muestra, y media contiene la miniatura vertical con su tamaño.
- Hashtags de la descripciónLas etiquetas escritas en la descripción se enumeran en hashtags, listas para contarlas en todo un conjunto de resultados.
- Enlaces de Shorts listos para usarCada resultado incluye una URL youtube.com/shorts/ y el ID del video para consultas posteriores.
Parámetros de la YouTube Shorts Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Palabra clave con la que se buscan Shorts, de hasta 100 caracteres. |
results_limit | Opcional | Número de Shorts que se devuelven, de 1 a 200. El valor predeterminado es 25. |
Cómo usar la YouTube Shorts Search API
Busque con una palabra clave y lea los Shorts que coincidan.
- Envíe {"query": "meal prep", "results_limit": 25} por POST a /v1/youtube/search-shorts.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea los Shorts de results.items y continúe con results.next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/search-shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"meal prep","results_limit":25}'
# Each item is one Short with text, metrics.views_count and a shorts URL.Casos de uso de la YouTube Shorts Search API
- Investigación de ganchos para un tema: Lea las descripciones de los Shorts con más vistas para una palabra clave y vea qué aperturas y promesas atraen vistas.
- Seguimiento de una palabra clave en Shorts: Repita la misma búsqueda de forma periódica y compare qué ID de video entran o salen de los resultados.
- Recopilación de Shorts para un análisis más profundo: Reúna las URL de Shorts de un tema y envíelas a YouTube Videos para obtener el canal, los Me gusta y la fecha de publicación.
Consejos de expertos para la YouTube Shorts Search API
- Los resultados de búsqueda solo incluyen la descripción y el número de vistas, así que envíe las URL que conserve a YouTube Videos cuando necesite el canal o los Me gusta.
- El número de vistas proviene de un texto redondeado como 635K; compárelo por órdenes de magnitud y no como totales exactos.
- Las páginas posteriores repiten algunos Shorts de las anteriores, por lo que los resultados se deduplican por ID de video antes de contar para results_limit.
APIs relacionadas
Además de la YouTube Shorts 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 Search API — Busca videos públicos regulares por palabra clave con filtros de metadatos compatibles.
- YouTube Hashtag Search API — Encuentra videos públicos en los feeds de hashtags, con recolección de todo el contenido o solo de Shorts.
- YouTube Related Videos API — Enumera los videos recomendados junto a la URL de un video, con títulos, canales, vistas y miniaturas.
- YouTube Channel Search API — Encuentra canales por palabra clave, con nombres, número de suscriptores, avatares y fragmentos de la descripción.
- YouTube Channel Videos API
- YouTube Transcripts API
- YouTube Channels API
- YouTube Shorts 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 Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API