Launch pricing: 78% of pool capacity allocated. Rates rise as it fills. Lock in today's rate →
Skip to content

From Serper

This guide maps Serper's Google Search and Places endpoints to SerpWiz. For pricing, see Serper vs SerpWiz.

Requests

Serper SerpWiz
Search POST https://google.serper.dev/search GET https://api.serpwiz.com/v1/google/search
Places / Maps POST https://google.serper.dev/places GET https://api.serpwiz.com/v1/google/maps
API key X-API-KEY header X-API-Key header (header names aren't case-sensitive, so the same header works)
Parameters JSON body or query string Query string

Parameters

Serper SerpWiz Notes
q q Same.
gl gl Same two-letter country code.
hl hl Same language code.
page page Same: page numbers starting at 1.
tbs tbs Supported: qdr:h/d/w/m/y, li:1 and custom date ranges.
num — Search returns 10 results per page. For Maps, use num (1–20).
location location (Maps only) On Search, use gl for the country.

Responses

Serper SerpWiz
organic[] results[]
organic[].position results[].position
organic[].title results[].title
organic[].link results[].url
organic[].snippet results[].description
organic[].date results[].date
peopleAlsoAsk[] related_keywords.keywords[], as question text only
relatedSearches[] related_keywords.keywords[] (keyword)
knowledgeGraph knowledge_panel
places[] results[] from /v1/google/maps

See Google Search and Google Maps for every field.

Code: before and after

// Before: Serper
const res = await fetch("https://google.serper.dev/search", {
  method: "POST",
  headers: { "X-API-KEY": process.env.SERPER_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ q: "best crm for startups", gl: "us", page: 2 }),
});
const { organic } = await res.json();
organic.forEach(r => console.log(r.position, r.title, r.link));

// After: SerpWiz
const params = new URLSearchParams({ q: "best crm for startups", gl: "us", page: 2 });
const res = await fetch(`https://api.serpwiz.com/v1/google/search?${params}`, {
  headers: { "X-API-Key": process.env.SERPWIZ_API_KEY },
});
if (!res.ok) throw new Error((await res.json()).error.message);
const { results } = await res.json();
results.forEach(r => console.log(r.position, r.title, r.url));

Errors

  • SerpWiz errors come back as {"error": {"status", "code", "message", "request_id"}} with a matching HTTP status.
  • Retries: retry 429 and 503 after the Retry-After header. See Errors.
  • Charging: failed requests are never charged. The X-Credits-Charged header on every response shows what was billed.
← From SerpApi

This page as Markdown: /docs/migrate-serper.md