YouTube Search
Los resultados de búsqueda de YouTube son videos públicos regulares que coinciden con una palabra clave o una frase, con títulos, canales, miniaturas, duración, datos de publicación e interacción visible. Estos registros sirven para descubrir temas, investigar contenido, seguir a la competencia y analizar oportunidades.
Funcionalidades de la YouTube Search API
- Descubrimiento de videos sin URLDescubre videos públicos regulares sin necesidad de conocer sus URL de antemano.
- Orden de los resultadosOrdena los resultados por relevancia, fecha de publicación, calificación o número público de vistas.
- Ventanas de publicaciónFiltra los resultados por ventanas de publicación de una hora, un día, una semana, un mes o un año.
- Filtros de duración y subtítulosFiltra por duración corta, media o larga y, cuando se necesite, exige que haya subtítulos disponibles.
- Resultados de video normalizadosDevuelve metadatos de video normalizados, información del canal, miniaturas, duración, datos de publicación y métricas públicas.
Parámetros de la YouTube Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Palabra clave o frase que se usa para descubrir videos públicos. |
results_limit | Opcional | Cantidad máxima de resultados de videos públicos que se solicitan. Debe ser un entero positivo y su valor predeterminado es 100. |
sort_by | Opcional | Orden de los resultados. El valor predeterminado es relevance. |
published_within | Opcional | Ventana de publicación opcional, medida desde el momento de la solicitud. |
duration | Opcional | Categoría de duración de YouTube opcional. |
has_captions | Opcional | Filtro opcional de disponibilidad de subtítulos. Déjelo sin modificar para omitir este filtro. |
Cómo usar la YouTube Search API
Redacte la consulta como una estrategia de recuperación, no solo como una palabra clave. Comience con un alcance lo bastante amplio para explorar el panorama y luego agregue un filtro a la vez para ver qué decisión descartó candidatos.
- Defina el tema y la pregunta: mejores coincidencias temáticas, cobertura más reciente, elementos con muchas vistas o candidatos listos para transcripción.
- Envíe por POST query y results_limit, junto con solo el orden y los filtros que necesite esa pregunta, a /v1/youtube/search.
- Almacene la solicitud completa con el task_id y luego consulte /v1/tasks/{task_id} hasta que el descubrimiento termine con éxito o falle.
- Deduplique los resultados por ID de video, conserve el contexto de posición y collected_at, y pagine mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"NASA Artemis","results_limit":10,"sort_by":"date","published_within":"month","duration":"medium","has_captions":true}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Casos de uso de la YouTube Search API
- Investigación de temas y de mercado: Descubra videos públicos sobre productos, industrias, organizaciones, eventos o temas emergentes.
- Descubrimiento de creadores y competidores: Use los resultados de búsqueda y la información del canal que publica para identificar creadores, marcas o competidores relevantes.
- Monitoreo de videos recientes: Combine el orden por fecha y las ventanas de publicación para recopilar videos recientes y revisarlos o analizarlos.
- Conjuntos de datos listos para transcripción: Exija que haya subtítulos disponibles para encontrar videos destinados a la recopilación de transcripciones, el resumen, la clasificación o la búsqueda.
Consejos de expertos para la YouTube Search API
- Pruebe dos o tres variantes precisas de la consulta en lugar de esconder todos los conceptos en una sola frase larga. La coincidencia entre ellas suele aportar tanta información como las diferencias.
- Agregue los filtros de forma progresiva. Si especifica a la vez la ventana de publicación, la duración y los subtítulos, un resultado vacío da pocas pistas sobre qué restricción fue demasiado estrecha.
- Use date con published_within para el monitoreo; relevance sin ventana responde a una pregunta de investigación distinta y más amplia.
- La clasificación no es estable. Guarde la solicitud, el ID de tarea, el ID de video y collected_at siempre que importen la posición o la composición de la muestra.
- results_limit es un tope, no una garantía de que los resultados estén completos. La elegibilidad pública y los filtros elegidos pueden producir menos registros.
- Deduplique entre variantes de la consulta por ID de video, pero conserve qué consulta produjo cada coincidencia para un análisis de relevancia posterior.
- Cuando ya conozca una URL, use Videos para obtener detalles actualizados y Transcripts para el texto de subtítulos disponible, en lugar de buscarla una y otra vez.
APIs relacionadas
Además de la YouTube 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 Transcripts API — Obtiene las transcripciones disponibles en texto plano, con selección de idioma opcional.
- YouTube Channels API — Obtiene la identidad del canal público, imágenes, verificación y estadísticas visibles de audiencia.
- YouTube Videos API — Obtiene metadatos, miniaturas, duración e interacción desde URLs conocidas de videos o Shorts.
- 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 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 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 Related Videos API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API