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ámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Palabra clave para encontrar canales, de hasta 100 caracteres. |
results_limit | Opcional | Nú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.
- Envíe {"query": "home cooking", "results_limit": 20} por POST a /v1/youtube/search-channels.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- 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.
APIs relacionadas
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.
- YouTube Comments API
- YouTube Transcripts API
- YouTube 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 Search Suggestions API
- YouTube Trending Videos API