Contenido
YouTube Search Scraper
youtube.com
La búsqueda de YouTube se sirve mediante un endpoint de plugin dedicado en lugar de la obtención de página genérica. Dale una consulta y devuelve los resultados ya analizados: para cada vídeo el videoId y el título, el nombre, id y URL del canal, el número de visualizaciones como texto y como número, la duración como texto y en segundos, la antigüedad de publicación, las URL de miniaturas, un fragmento de descripción y distintivos como verificado, en directo o CC. Filtra por tipo (vídeo, canal, playlist o todos) y orden (relevancia, fecha, visualizaciones o valoración), y recopila tantos resultados como necesites por páginas. Lee los propios datos de búsqueda de YouTube, así que no hay ninguna API de InnerTube que aplicar ingeniería inversa.
Qué puedes extraer
- Id de vídeo, título y una URL de reproducción
- Nombre, id y URL del canal
- Número de visualizaciones como texto y número analizado
- Duración como texto y en segundos
- Antigüedad de publicación y URL de miniaturas
- Fragmento de descripción y distintivos (verificado / en directo / CC)
Endpoints dedicados
/content/youtube-search Resultados de búsqueda de YouTube
Resultados de búsqueda para una consulta: cada vídeo con videoId, título, canal (nombre/id/url), número de visualizaciones (texto + número), duración (texto + segundos), antigüedad de publicación, miniaturas, un fragmento de descripción y distintivos. Filtra con type (vídeo / canal / playlist / todos) y sort (relevancia / fecha / visualizaciones / valoración); recopila hasta max_results por páginas.
Cómo rastrearlo
curl -X POST \
-H "X-ScrapeUnblocker-Key: $SU_API_KEY" \
"https://api.scrapeunblocker.com/content/youtube-search?query=python%20tutorial&max_results=40"import requests
resp = requests.post(
"https://api.scrapeunblocker.com/content/youtube-search",
headers={"X-ScrapeUnblocker-Key": SU_API_KEY},
params={"query": "python tutorial", "max_results": "40"},
)
print(resp.text)import { ScrapeUnblockerClient } from 'scrapeunblocker';
const su = new ScrapeUnblockerClient({ apiKey: process.env.SU_API_KEY });
const data = await su.youtubeSearch('python tutorial', { maxResults: 40, type: 'video', sort: 'views' });
console.log(data);Las peticiones son POST y sus parámetros van en la query string. El renderizado en navegador siempre ocurre: no hay ningún flag que activar.
Preguntas frecuentes
¿Es legal hacer scraping de los resultados de búsqueda de YouTube?
Recopilar datos públicos de búsqueda de YouTube como títulos de vídeos, nombres de canales y número de visualizaciones es lícito en muchas jurisdicciones, pero las normas dependen de tu país, de los datos que recopiles y de cómo los uses. Parte de estos datos pueden ser personales, así que cumple las normas de privacidad que se te apliquen. ScrapeUnblocker devuelve la página pública; qué recopilas y cómo lo usas es responsabilidad tuya.
¿Cómo hago scraping de la búsqueda de YouTube sin que me bloqueen?
La búsqueda de YouTube está protegida por los sistemas anti-bot propios de Google. ScrapeUnblocker rota exits residenciales e ISP y gestiona los desafíos, y el plugin YouTube Search devuelve los resultados como JSON parseado. En el benchmark de ScrapeUnblocker devolvió contenido real en el 99,2 % de 1.164 llamadas, unos 1,7 s por llamada.
¿Qué datos de la búsqueda de YouTube puedo obtener?
Para cada resultado: id del vídeo, título y URL de reproducción, nombre, id y URL del canal, número de visualizaciones como texto y como número analizado, duración como texto y en segundos, antigüedad de publicación, URLs de miniaturas, un fragmento de la descripción y distintivos como verified, live o CC. Filtra por tipo (video, channel, playlist o all) y ordena por relevancia, fecha, visualizaciones o valoración.
¿Necesito una clave de API o una cuenta de YouTube?
No. El plugin YouTube Search devuelve resultados de búsqueda como JSON sin cuenta de API de YouTube, clave de API ni inicio de sesión por tu parte. Indica una consulta, y no hay ninguna API InnerTube que tengas que descifrar por tu cuenta.
¿Puedo seguir los resultados de búsqueda de YouTube a escala?
Sí. Cada llamada reúne hasta max_results entre páginas, unos 20 resultados por página, y las llamadas se ejecutan en paralelo hasta el límite de concurrencia de tu plan: de 20 a 100 solicitudes concurrentes en Pay as you go, Starter y Pro, y de 200 a 400 en Business, Scale y Ultimate. Eso cubre el seguimiento de posiciones en muchas consultas.
¿Cuánto cuesta hacer scraping de la búsqueda de YouTube?
El precio es por petición: 1 petición = 1 crédito, desde 1,00 EUR por cada 1.000 en Pay as you go hasta unos 0,55 EUR por cada 1.000 en el plan Ultimate. Las llamadas a plugins usan la misma cuota del plan que cualquier otra petición. Una llamada devuelve los resultados de una consulta, reunidos entre páginas hasta max_results. No se facturan los bloqueos, los timeouts ni los errores del lado de ScrapeUnblocker, y la prueba gratuita incluye 500 peticiones sin tarjeta.
Scrapers relacionados
Empieza a rastrear este sitio hoy
Plan gratuito incluido. No necesitas tarjeta para probarlo.