SerpBase

Endpoint compatível com a SerpApi

Código escrito para a SerpApi funciona aqui trocando só a URL base: os mesmos nomes de engine, parâmetros e campos de resposta, com preços da SerpBase.

Como trocar

Troque https://serpapi.com/search.json pela URL abaixo e use sua chave da SerpBase como api_key. As solicitações são GET, como na SerpApi. A chave também pode ir no cabeçalho X-API-Key, o que a mantém fora de URLs e logs.

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 roda no endpoint da SerpBase da segunda coluna e custa o mesmo que ele. Um engine fora da lista é recusado com 400.

engineRoda emCréditos por solicitação
googleGoogle Web Search1
google_imagesGoogle Images Search1
google_newsGoogle News Search1
google_videosGoogle Videos Search1
google_autocompleteGoogle Search Autocomplete1
google_shoppingGoogle Shopping Search2
google_jobsGoogle Jobs Search2
google_patents_detailsGoogle Patent Details2
google_playGoogle Play Search1
google_play_productGoogle Play App Details1
google_trendsGoogle Trends2
google_trends_autocompleteGoogle Trends Autocomplete2
google_trends_trending_nowGoogle Trends Trending Now2
google_mapsGoogle Maps Search2
google_maps_reviewsGoogle Maps Reviews2
duckduckgoDuckDuckGo Search1
youtubeYouTube Search1
youtube_video_transcriptYouTube Video Transcripts2
amazonAmazon Product Search2
amazon_productAmazon Product Details2
amazon_autocompleteAmazon Search Autocomplete1
walmartWalmart Product Search2
walmart_productWalmart Product Details2
ebayeBay Product Search1
ebay_producteBay Product Details2
apple_productApple Product Details1

Diferenças em relação à SerpApi

  • Os campos são os que a SerpBase extrai, com os nomes da SerpApi. Um campo que a SerpBase não produz é omitido em vez de preenchido, então verifique se existe antes de ler.
  • Não disponível: output=html (exceto engine=google), buscas de lugar no google_maps (use /google/maps/detail), tipos do google_trends além de TIMESERIES, lojas do Play além de apps e as APIs de conta, arquivo e async da SerpApi. no_cache, async e json_restrictor são aceitos sem efeito.
  • Os erros seguem a SerpApi: uma solicitação recusada recebe 400, 401 ou 429 com {"error": …}; uma busca que rodou e falhou recebe 200 com search_metadata.status "Error". Buscas que falham não são cobradas.