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
- Set the base URL to
https://api.bestserp.com. - Replace the key with a BestSERP key (authentication).
- 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"}'