APIs · Google

Las APIs de Google que de verdad sirven para tu sitio

Google expone por API casi todo lo que ves en sus productos: datos de lugares y reseñas, mediciones de velocidad, tus propias estadísticas de búsqueda. Estas son las cuatro APIs que más rinden para quien construye sitios, con el comando exacto para probar cada una desde la terminal.

Capa gratuita en todas Ejemplos con curl

Consigue tu API key

Todas las APIs de Google se administran en console.cloud.google.com. El flujo es siempre el mismo:

Crea un proyecto (arriba a la izquierda, "Nuevo proyecto").
En APIs y servicios → Biblioteca, busca la API que quieres y selecciona Habilitar.
En Credenciales → Crear credenciales → Clave de API obtienes tu llave.
Las APIs de Maps/Places piden facturación activa (tarjeta), aunque tienen capa gratuita mensual por categoría de llamada — un sitio típico no llega a pagar.

Restringe la llave. En la configuración de la credencial, limítala a las APIs que usas y — si va en un sitio público — a tu dominio. Una llave sin restricciones que se filtra en tu código es una factura sorpresa.

Places API: datos de cualquier lugar del mundo

Nombre, dirección, teléfono, horario, calificación, reseñas y fotos de millones de lugares. Una búsqueda de texto con la versión nueva de la API:

curl -X POST "https://places.googleapis.com/v1/places:searchText" \
  -H "Content-Type: application/json" \
  -H "X-Goog-Api-Key: TU_API_KEY" \
  -H "X-Goog-FieldMask: places.displayName,places.formattedAddress,places.rating,places.userRatingCount" \
  -d '{"textQuery": "cafeterías en Monterrey centro", "languageCode": "es"}'

El FieldMask es obligatorio y define qué pagas: pide solo los campos que necesitas.

Places API: descargar las fotos de un lugar

Pide el campo places.photos en la búsqueda y cada foto trae un name. Con él descargas la imagen:

curl -L -o lugar.jpg \
  "https://places.googleapis.com/v1/NOMBRE_DE_LA_FOTO/media?key=TU_API_KEY&maxWidthPx=1200"

Descarga las fotos a archivos locales en tu build — no incrustes la URL de la API en tu HTML, porque expone tu llave y cobra en cada visita.

PageSpeed Insights API: velocidad medida por Google

La misma medición de pagespeed.web.dev, por API y gratis. Puntaje de rendimiento de cualquier URL:

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)"

Para auditorías completas desde la terminal (rendimiento, SEO, accesibilidad), usa Lighthouse, que es el motor detrás de esta API.

Search Console API: tus datos de búsqueda, programables

Todo lo del reporte de rendimiento de Search Console — consultas, clics, impresiones, posición — consultable por código. Requiere OAuth (no basta la API key): crea una cuenta de servicio en tu proyecto de Cloud, y agrégala como usuario en la propiedad de Search Console. Con eso puedes exportar a diario tus mil consultas principales por página, algo que la interfaz no te deja automatizar.

Custom Search JSON API: búsquedas de Google por código

Resultados de búsqueda programables, 100 consultas gratis al día. Crea un buscador en programmablesearchengine.google.com (puede buscar en toda la web), copia su ID y:

curl -s "https://www.googleapis.com/customsearch/v1?key=TU_API_KEY&cx=TU_ID_DE_BUSCADOR&q=tu+busqueda&hl=es"

Útil para monitorear dónde aparece tu marca o vigilar qué publica tu competencia, desde un script.

Una advertencia sobre la Indexing API

Circulan tutoriales que la recomiendan para indexar cualquier página al instante. Oficialmente solo está soportada para ofertas de empleo y transmisiones en vivo; usarla para otra cosa es jugar con la suspensión. Para avisos de contenido nuevo, el camino legítimo es el sitemap en Search Console y, para Bing y compañía, IndexNow.