← Volver al blog

Cómo Usar una Google Search API en 2026: Guía Completa

Aprende a usar una Google Search API de principio a fin: auth, parámetros, análisis, paginación y control de costes, con código en Python, Node.js y curl.

2 min de lectura

Esta es la guía práctica y completa para usar una Google Search API: autenticarse, enviar una consulta, leer el JSON, paginar, gestionar errores y mantener bajos los costes. Los ejemplos usan serp.cheap (la opción más barata en 2026), pero los conceptos se aplican a cualquier SERP API.

1. Consigue una clave de API

Crea una cuenta gratuita directamente en app.serp.cheap/login: obtienes 100 búsquedas gratis sin tarjeta y una clave que pasas en la cabecera X-API-Key. Los créditos son válidos durante 12 meses. ¿Prefieres pagar con tarjeta? serp.cheap también está disponible en Apify y RapidAPI.

2. El endpoint en una línea

POST https://api.serp.cheap/v1/search
ParámetroPredeterminadoDescripción
qobligatorioLa consulta de búsqueda
gl"us"País (p. ej. br, gb, de)
hlpredeterminado del paísAnulación del idioma de la interfaz
page1Página de resultados (índice desde 1)
tbsningunoFiltro temporal: qdr:h, qdr:d, qdr:w

Referencia completa: parámetros de la Google Search API.

3. Tu primera petición

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}'
import requests

r = requests.post(
    "https://api.serp.cheap/v1/search",
    headers={"X-API-Key": "YOUR_KEY"},
    json={"q": "best electric cars 2026", "gl": "us", "page": 1},
)
r.raise_for_status()
data = r.json()
for item in data["organic"]:
    print(item["position"], item["title"], item["link"])

Guías por lenguaje: Python · Node.js · PHP · Go · curl.

4. Lee la respuesta

{
  "search": "best electric cars 2026",
  "page": 1,
  "organic": [
    {
      "position": 1,
      "title": "Best Electric Cars of 2026",
      "link": "https://example.com/best-evs",
      "snippet": "We tested every major EV...",
      "date": "Jan 10, 2026"
    }
  ],
  "stats": { "balance": 99994, "cost": 6, "cached": false }
}

stats.cost se expresa en créditos (1 crédito = $0.0001). Una búsqueda fresca son 6 créditos ($0.0006); un acierto de caché son 3 ($0.0003). stats.cached te indica qué ruta obtuviste.

5. Paginación

Cada página es una petición separada: incrementa page. Obtén la página 2 o posteriores solo cuando un usuario realmente la necesite. Consulta cómo obtener 100 resultados.

6. Gestión de errores

  • 401 — clave de API incorrecta o ausente.
  • 402 — sin créditos; recarga.
  • 429 — límite de tasa alcanzado (60 req/min en el nivel gratuito, 600 req/min en pago por uso, hasta 60 req/s en planes superiores); espera y reintenta.
  • 5xx — transitorio; reintenta con retroceso exponencial.

Envuelve siempre las llamadas en un reintento con retroceso para 429/5xx.

7. Mantenlo barato

  1. Los aciertos de caché cuestan la mitad — no fuerces búsquedas frescas para consultas repetidas.
  2. Pagina de forma diferida.
  3. Elige gl con precisión para evitar repeticiones.

Próximos pasos

Preguntas frecuentes

¿Cómo llamo a una Google Search API?+

Envía una petición POST autenticada con tu consulta. Con serp.cheap: POST https://api.serp.cheap/v1/search, cabecera X-API-Key, cuerpo JSON como {"q": "...", "gl": "us"}. La respuesta es JSON con un array organic[] de resultados.

¿Puedo llamar a una Google Search API desde el navegador?+

No: nunca expongas tu clave de API en el código del lado del cliente. Envía siempre las peticiones a través de tu propio backend para que la clave permanezca secreta.

¿Cómo mantengo bajos los costes de la Google Search API?+

Apóyate en la caché (las consultas repetidas se sirven a mitad de precio en serp.cheap), obtén páginas adicionales solo cuando sea necesario y monitoriza stats.cost por llamada.

Obtén tu clave de API

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