youtube/
search

Busque videos públicos de YouTube por palabra clave con filtros de orden, fecha, duración y subtítulos, con metadatos normalizados, contexto del canal, miniaturas e interacción.

YouTube Search API

Búsqueda de videos
Descubrimiento
Filtros portables
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 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ámetrosObligatorioDescripción
queryObligatorioPalabra clave o frase que se usa para descubrir videos públicos.
results_limitOpcionalCantidad máxima de resultados de videos públicos que se solicitan. Debe ser un entero positivo y su valor predeterminado es 100.
sort_byOpcionalOrden de los resultados. El valor predeterminado es relevance.
published_withinOpcionalVentana de publicación opcional, medida desde el momento de la solicitud.
durationOpcionalCategoría de duración de YouTube opcional.
has_captionsOpcionalFiltro 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.

  1. Defina el tema y la pregunta: mejores coincidencias temáticas, cobertura más reciente, elementos con muchas vistas o candidatos listos para transcripción.
  2. Envíe por POST query y results_limit, junto con solo el orden y los filtros que necesite esa pregunta, a /v1/youtube/search.
  3. Almacene la solicitud completa con el task_id y luego consulte /v1/tasks/{task_id} hasta que el descubrimiento termine con éxito o falle.
  4. 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=50

Casos 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.

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.

Explorar otras plataformas

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

YouTube Search API — FAQ

YouTube Search API encuentra videos públicos regulares a partir de una palabra clave o una frase, con filtros y órdenes compatibles. Devuelve metadatos normalizados, información del canal, miniaturas, duración, fechas de publicación, métricas de interacción y hora de recopilación.

Envíe una palabra clave o una frase no vacía, como un tema, una persona, un producto, una organización, una marca, una campaña o un evento.

sort_by acepta relevance, date, rating o view_count. relevance es el valor predeterminado.

Puede filtrar por published_within, duration y has_captions. Las ventanas de publicación son hour, day, week, month o year; los valores de duración son short, medium o long.

No. Los resultados son una muestra pública limitada y pueden cambiar según el posicionamiento, la actualidad, la región, el idioma, la disponibilidad y los filtros elegidos.

No. has_captions filtra por disponibilidad de subtítulos. Use Transcripts para obtener los subtítulos disponibles en texto plano de las URL de videos seleccionadas.

El uso cuesta 0.5 créditos por cada resultado de búsqueda normalizado devuelto.