Obtener los resultados correctos de una Google Search API depende principalmente de los parámetros. Aquí tienes la referencia completa, usando serp.cheap.
Todos los parámetros
| Parámetro | Tipo | Predeterminado | Qué hace |
|---|---|---|---|
q | string | obligatorio | La consulta de búsqueda |
gl | string | "us" | País de los resultados (geolocalización) |
hl | string | predeterminado del país | Idioma de interfaz/visualización |
page | int | 1 | Página de resultados (índice desde 1) |
tbs | string | ninguno | Filtro de tiempo (qdr:h/qdr:d/qdr:w) |
gl — país (el que más usarás)
gl decide qué Google consultas y qué rankings regionales obtienes. Soportados: us, br, gb, de, fr, es, it, mx, ca, au, jp, nl.
-d '{"q": "beste elektroautos", "gl": "de"}' # Germany
-d '{"q": "melhores carros elétricos", "gl": "br"}' # Brazilhl — anular el idioma
gl ya establece un idioma predeterminado razonable. Usa hl solo cuando quieras resultados en un idioma diferente al predeterminado del país:
-d '{"q": "best laptops", "gl": "ca", "hl": "fr"}' # Canada, in Frenchtbs — filtro de tiempo
Restringe a resultados recientes: ideal para noticias, monitoreo y temas de tendencia:
-d '{"q": "ai news", "gl": "us", "tbs": "qdr:d"}' # past 24 hours| Valor | Ventana |
|---|---|
qdr:h | Última hora |
qdr:d | Último día |
qdr:w | Última semana |
page — paginación
Índice desde 1; cada página es una petición facturada por separado. Consulta cómo obtener 100 resultados.
Poniéndolo todo junto
curl https://api.serp.cheap/v1/search \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"q": "mortgage rates", "gl": "us", "hl": "en", "page": 1, "tbs": "qdr:w"}'