Endpoint compatible con SerpApi
El código escrito para SerpApi funciona aquí cambiando solo la URL base: los mismos nombres de engine, parámetros y campos de respuesta, a precios de SerpBase.
Cómo cambiar
Sustituye https://serpapi.com/search.json por la URL de abajo y usa tu clave de SerpBase como api_key. Las solicitudes son GET, como en SerpApi. La clave también puede ir en la cabecera X-API-Key, que la mantiene fuera de URL y registros.
BASH
curl "https://api.serpbase.dev/google/serpapi/search.json?engine=google&q=coffee&gl=us&hl=en" \
-H "X-API-Key: YOUR_API_KEY"
curl "https://api.serpbase.dev/google/serpapi/search.json?engine=amazon&k=headphones&amazon_domain=amazon.com" \
-H "X-API-Key: YOUR_API_KEY"PYTHON
import requests
res = requests.get(
"https://api.serpbase.dev/google/serpapi/search.json",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"engine": "google_news", "q": "semiconductors", "gl": "us"},
)
print(res.json()["news_results"][0]["title"])Engines
Cada engine se ejecuta en el endpoint de SerpBase de la segunda columna y cuesta lo mismo que él. Un engine fuera de la lista se rechaza con 400.
| engine | Se ejecuta en | Créditos por solicitud |
|---|---|---|
google | Google Web Search | 1 |
google_images | Google Images Search | 1 |
google_news | Google News Search | 1 |
google_videos | Google Videos Search | 1 |
google_autocomplete | Google Search Autocomplete | 1 |
google_shopping | Google Shopping Search | 2 |
google_jobs | Google Jobs Search | 2 |
google_patents_details | Google Patent Details | 2 |
google_play | Google Play Search | 1 |
google_play_product | Google Play App Details | 1 |
google_trends | Google Trends | 2 |
google_trends_autocomplete | Google Trends Autocomplete | 2 |
google_trends_trending_now | Google Trends Trending Now | 2 |
google_maps | Google Maps Search | 2 |
google_maps_reviews | Google Maps Reviews | 2 |
duckduckgo | DuckDuckGo Search | 1 |
youtube | YouTube Search | 1 |
youtube_video_transcript | YouTube Video Transcripts | 2 |
amazon | Amazon Product Search | 2 |
amazon_product | Amazon Product Details | 2 |
amazon_autocomplete | Amazon Search Autocomplete | 1 |
walmart | Walmart Product Search | 2 |
walmart_product | Walmart Product Details | 2 |
ebay | eBay Product Search | 1 |
ebay_product | eBay Product Details | 2 |
apple_product | Apple Product Details | 1 |
Diferencias con SerpApi
- Los campos son los que extrae SerpBase, con los nombres de SerpApi. Un campo que SerpBase no produce se omite en lugar de rellenarse, así que comprueba que exista antes de leerlo.
- No disponible: output=html (salvo engine=google), búsquedas de lugar en google_maps (usa /google/maps/detail), tipos de google_trends distintos de TIMESERIES, tiendas de Play distintas de apps y las API de cuenta, archivo y async de SerpApi. no_cache, async y json_restrictor se aceptan sin efecto.
- Los errores siguen a SerpApi: una solicitud rechazada recibe 400, 401 o 429 con {"error": …}; una búsqueda que se ejecutó y falló recibe 200 con search_metadata.status "Error". Las búsquedas fallidas no se cobran.