SerpCheap
Browse documentation

SERPCHEAP / API reference

Google Search API

The request contract, response fields and snapshot access for POST /search.

On this page

Endpoint & authentication

HTTP
POST https://serpcheap.com/search
X-API-KEY: YOUR_API_KEY
Content-Type: application/json

X-API-KEY is required. Every successful request uses one credit, including repeated queries.

Request parameters

FieldRequired / defaultDescription
qRequiredQuery, up to 2000 UTF-8 bytes.
glusCountry code, for example us or de.
hlenSearch language, for example en or de.

Only the first page of Google web search is supported. Pagination, custom result counts and unknown parameters are rejected.

Response structure

Illustrative response below. Results retain their original positions; a fixed count is not guaranteed. Optional modules appear only when available.

JSON
{
  "search_metadata": {"request_time_ms": 1480.320, "parse_time_ms": 12.480},
  "searchParameters": {"q": "Nike", "gl": "us", "hl": "en"},
  "organic": [{
    "title": "Nike",
    "link": "https://www.nike.com/",
    "snippet": "Illustrative result, not a live search.",
    "position": 1
  }],
  "peopleAlsoAsk": [],
  "relatedSearches": [],
  "credits": 1
}

search_metadata.request_time_ms and parse_time_ms are JSON numbers in milliseconds, emitted with three decimal places. Values may include simulated timings and server-side waiting; they are not always measurements of upstream network or parser CPU time. End-to-end response time also includes authentication, database settlement and network transport.

FieldMeaning
searchParametersq / gl / hl
organic / adsOrganic and ad results: title, link, snippet, position; source, displayed_link, favicon, sitelinks and highlights when present.
peopleAlsoAsk / relatedSearchesRelated questions and search suggestions.
knowledgeGraph / answerBoxKnowledge graph and answer box when available.
ai_overview / inline_images / search_information / paginationAdditional page modules when available.
creditsOne credit for a successful request.

HTML snapshots

When available, search_metadata.html_url opens the HTML snapshot directly in your browser. No login or API key is required: anyone with this link can view it. Scripts and automatic redirects are disabled. Snapshots expire after 24 hours; missing or expired snapshots return 404.

CURL
curl 'https://serpcheap.com/searches/YOUR_REQUEST_ID/html'

Request tracing

Save X-Request-ID from the response header. If a link cannot be resolved, the original Google /goto URL may be retained. Only organic and ad main links are resolved; other modules keep their original links.

OpenAPI JSON

Examples describe the API contract and do not execute searches. Never share your API key with support.