Browse documentation
No matching documents
SERPCHEAP / API reference
Google Search API
The request contract, response fields and snapshot access for POST /search.
On this page
Endpoint & authentication
POST https://serpcheap.com/search
X-API-KEY: YOUR_API_KEY
Content-Type: application/jsonX-API-KEY is required. Every successful request uses one credit, including repeated queries.
Request parameters
| Field | Required / default | Description |
|---|---|---|
| q | Required | Query, up to 2000 UTF-8 bytes. |
| gl | us | Country code, for example us or de. |
| hl | en | Search 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.
{
"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.
| Field | Meaning |
|---|---|
| searchParameters | q / gl / hl |
| organic / ads | Organic and ad results: title, link, snippet, position; source, displayed_link, favicon, sitelinks and highlights when present. |
| peopleAlsoAsk / relatedSearches | Related questions and search suggestions. |
| knowledgeGraph / answerBox | Knowledge graph and answer box when available. |
| ai_overview / inline_images / search_information / pagination | Additional page modules when available. |
| credits | One 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 '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 JSONExamples describe the API contract and do not execute searches. Never share your API key with support.
