youtube/
search-channels

Busque canales de YouTube por palabra clave y obtenga los ID de canal, los nombres, el número de suscriptores, los avatares y el fragmento de descripción que muestra YouTube, en el orden de búsqueda.

YouTube Channel Search API

Entrada por palabra clave
Número de suscriptores
Hasta 200 canales
0.6 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 Channel Search

Los resultados de búsqueda de canales son las cuentas de creadores de contenido que YouTube asocia a una palabra clave, cada una con su nombre, avatar, número de suscriptores y las primeras líneas de su descripción. Revisarlos es la forma más rápida de evaluar quién cubre un tema, distinguir los canales grandes de los emergentes y armar una primera lista para investigar creadores o contactarlos.

Funcionalidades de la YouTube Channel Search API

  • Solo canalesLa búsqueda se limita a canales, de modo que una palabra clave como home cooking devuelve cuentas de creadores y no una mezcla de videos y listas de reproducción.
  • Número de suscriptores por canalmetrics.followers_count contiene el total de suscriptores obtenido de la cifra que muestra YouTube, como 3.69M.
  • ID y enlaces de canal establesCada resultado incluye el ID de canal UC y una URL de canal construida a partir de él, listos para las API de canales.
  • Fragmento de la descripcióntext contiene el extracto de la descripción que aparece en la búsqueda, que a menudo nombra el nicho o incluye un contacto comercial.

Parámetros de la YouTube Channel Search API

ParámetrosObligatorioDescripción
queryObligatorioPalabra clave para encontrar canales, de hasta 100 caracteres.
results_limitOpcionalNúmero de canales que se devuelven, de 1 a 200. El valor predeterminado es 20.

Cómo usar la YouTube Channel Search API

Busque con una palabra clave y recorra página por página los canales que coincidan.

  1. Envíe {"query": "home cooking", "results_limit": 20} por POST a /v1/youtube/search-channels.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. Lea los canales de results.items y vuelva a enviar results.next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/search-channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"home cooking","results_limit":20}'

# Each item is one channel with name, text and metrics.followers_count.

Casos de uso de la YouTube Channel Search API

  • Creación de una lista de creadores: Busque las palabras clave de su nicho y conserve los canales cuyo followers_count esté dentro del rango de tamaño con el que trabaja.
  • Identificación de quién domina un tema: Compare el número de suscriptores de los primeros resultados de una palabra clave para juzgar si unos pocos canales grandes la dominan.
  • Punto de partida para investigar canales: Envíe las URL de canal devueltas a YouTube Channels y YouTube Channel Videos para perfilar a fondo a cada creador.

Consejos de expertos para la YouTube Channel Search API

  • El número de suscriptores proviene de un texto redondeado, así que use YouTube Channels cuando necesite la cifra exacta a la unidad.
  • Pruebe varias formulaciones de un tema y combine los resultados por el id del canal para ampliar la lista.
  • Envíe los canales prometedores a YouTube Email Finder para ver si publican un contacto comercial.

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

  • YouTube Channel Videos API — Recolecta videos públicos regulares desde URLs de canales, sin incluir Shorts ni transmisiones en vivo.
  • YouTube Channels API — Obtiene la identidad del canal público, imágenes, verificación y estadísticas visibles de audiencia.
  • 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 Shorts Search API — Busca Shorts por palabra clave, con enlaces, descripciones, número de vistas y miniaturas verticales.
  • YouTube Email Finder API — Encuentra los correos comerciales públicos de la URL de un canal, con las páginas donde aparece cada dirección.

Explorar otras plataformas

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

YouTube Channel Search API — FAQ

YouTube Channel Search API es una interfaz programática para encontrar canales de YouTube que coinciden con una palabra clave. Devuelve los ID de canal, los nombres, el número de suscriptores, los avatares y los fragmentos de descripción en el orden de búsqueda de YouTube.

Asigne a results_limit un valor de 1 a 200; el valor predeterminado es 20. Los resultados se paginan automáticamente hasta llegar al límite o al final de los resultados de YouTube.

Los resultados de búsqueda identifican los canales por su ID de canal UC y su URL de canal. Envíe esa URL a YouTube Channels para obtener el handle y el perfil completo.

No. Las solicitudes usan su clave de API de SocQ y se facturan en créditos por canal devuelto, así que no hay que administrar ningún proyecto de Google Cloud ni ninguna cuota diaria.

Cada canal devuelto cuesta 0.6 créditos, por lo que los 20 canales predeterminados cuestan 12 créditos.