Migrate from Serper

Move a Serper integration to BestSERP: same endpoints, parameters and field names; change the base URL and key, and check the few differences listed here.

Updated View as Markdown

BestSERP uses the same paths (/search, /images, /news, /videos, /shopping, /places, /maps), the same JSON body (q, gl, hl, num, page, tbs), the X-API-KEY header and the same camelCase field names as Serper's Google API. Most clients only change two values.

Steps

  1. Set the base URL to https://api.bestserp.com.
  2. Replace the key with a BestSERP key (authentication).
  3. Run your test suite against the differences below.

Differences

Topic BestSERP
location Not supported yet: refused with unsupported_parameter. Put the city in q.
knowledgeGraph, peopleAlsoAsk, relatedSearches, answerBox Not returned.
sitelinks on organic results Not returned.
Places type Returned as category.
Places website, phoneNumber, description Not returned.
Extra fields domain, favicon, unresolvedLinks, linksPending, ipCountry, requestId, credits, durationMs.
Long searches May answer 202: poll /requests/{requestId} (async).

The Serper comparison lists prices and what Serper does better.

The same request, pointed at BestSERP
curl -X POST 'https://api.bestserp.com/search' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"q":"coffee","gl":"us","hl":"en"}'