← Volver al blog

API de Google Search con curl: Referencia rápida (2026)

Llama a una API de Google Search desde la línea de comandos con curl: auth, parámetros de país y filtro temporal, paginación y cómo enviar JSON a jq.

1 min de lectura

La forma más rápida de probar una API de Google Search es desde tu terminal. Los ejemplos usan serp.cheap.

Solicitud básica

curl https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "best electric cars 2026", "gl": "us", "page": 1}'

Filtros de país y tiempo

# Resultados de Brasil, últimas 24 horas
curl https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"q": "eleições", "gl": "br", "tbs": "qdr:d"}'

Consulta todas las opciones en parámetros de la API de Google Search.

Formatear e extraer con jq

# Solo los enlaces orgánicos
curl -s https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"q": "serp api curl", "gl": "us"}' | jq -r '.organic[].link'

# Título + enlace como TSV
... | jq -r '.organic[] | [.position, .title, .link] | @tsv'

# ¿Cuánto costó esta llamada?
... | jq '.stats'

Paginación

for p in 1 2 3; do
  curl -s https://api.serp.cheap/v1/search \
    -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
    -d "{\"q\": \"serp api\", \"page\": $p}" | jq -r '.organic[].link'
done

Mantén tu clave en una variable de entorno (-H "X-API-Key: $SERP_KEY") en lugar de pegarla en los scripts.

Siguiente

Preguntas frecuentes

¿Cómo pruebo una API de Google Search con curl?+

Haz un POST con un cuerpo JSON y tu clave en la cabecera: curl https://api.serp.cheap/v1/search -H 'X-API-Key: KEY' -H 'Content-Type: application/json' -d '{"q":"...","gl":"us"}'.

¿Cómo extraigo solo los enlaces?+

Envía la respuesta a jq: ... | jq -r '.organic[].link'.

Obtén tu clave de API

Más barato directo, paga con tarjeta o cripto, sin KYC. O usa un marketplace.