APIs · Google
Medir velocidad con PageSpeed API
La PageSpeed Insights API es la misma medición de pagespeed.web.dev, pero por API y gratis. Te da el puntaje de rendimiento de cualquier URL, listo para automatizar — sin instalar nada, porque Lighthouse es el motor que corre del lado de Google.
1. Saca el puntaje de rendimiento de una URL
Con una API key, esta llamada devuelve el JSON completo y la tubería extrae solo el puntaje de rendimiento (0 a 100):
curl -s "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=https://ejemplo.com&strategy=mobile&key=TU_API_KEY" \
| python3 -c "import sys,json; d=json.load(sys.stdin); print(d['lighthouseResult']['categories']['performance']['score']*100)"El parámetro strategy=mobile mide la experiencia móvil, la que Google usa para ranking; cámbialo a desktop para la de escritorio.
Si quieres la auditoría completa local
Para auditorías completas desde la terminal — rendimiento, SEO y accesibilidad, con la lista de problemas — usa Lighthouse, que es el mismo motor detrás de esta API pero corriendo en tu equipo. La diferencia: la API no instala nada y la herramienta local te da el reporte detallado. Guía: PageSpeed Insights API.
Tareas relacionadas
Preguntas frecuentes
¿La PageSpeed API da el mismo resultado que Lighthouse local?
Usa el mismo motor, Lighthouse, así que la metodología coincide. El puntaje puede variar un poco entre corridas por la red y el servidor donde se ejecuta. La API es cómoda para vigilancia automática; Lighthouse local, para el detalle de qué arreglar.
¿Qué mide strategy=mobile frente a strategy=desktop?
mobile simula un teléfono con red lenta —la condición que Google usa para evaluar la experiencia móvil, la que pesa en ranking—, y desktop simula un equipo de escritorio con buena conexión. Conviene mirar la móvil primero.
¿Necesito API key para usar PageSpeed Insights?
Para uso puntual puedes consultar pagespeed.web.dev en el navegador sin clave. Para llamadas programáticas y un cupo más holgado conviene una API key; la medición es gratuita dentro de los límites del servicio.