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ámetro | Predeterminado | Descripción |
|---|---|---|
q | obligatorio | La consulta de búsqueda |
gl | "us" | País (p. ej. br, gb, de) |
hl | predeterminado del país | Anulación del idioma de la interfaz |
page | 1 | Página de resultados (índice desde 1) |
tbs | ninguno | Filtro 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
- Los aciertos de caché cuestan la mitad — no fuerces búsquedas frescas para consultas repetidas.
- Pagina de forma diferida.
- Elige
glcon precisión para evitar repeticiones.
Próximos pasos
-
Construye algo real: un rastreador de posiciones en Python o Google Search para agentes de IA.
-
Compara proveedores: la SERP API más barata de 2026.