Serper compatibility

Serper-compatible Google web search

Set SERPER_BASE_URL=https://api.litescrape.com and use a Litescrape key in SERPER_API_KEY. Accepts one query as JSON or query parameters; JSON fields take precedence. Returns Serper searchParameters, organic and source-provided rich results. One successful request consumes one Litescrape call.

post/search

Request

  • Base URL: https://api.litescrape.com
  • URL: https://api.litescrape.com/search
  • Auth: one of:
    • API key in header X-API-KEY
    • HTTP bearer

Query parameters

qstring

Search query. Required, non-empty, at most 2,048 characters.

Example:coffee brewing
glstring

Lowercase two-letter country code.

Example:us
hlstring

Language code, such as en or fr.

Example:en
locationstring

Human-readable search location, up to 512 characters, using the native Google Search location rules.

Example:Austin, Texas, United States
numinteger

Integer from 1 to 10; caps the returned organic results.

Example:10
pageinteger

Result page, starting at 1. Translates to native start=(page-1)*num.

Example:2
autocorrectboolean

Set false to disable Google's spelling correction.

tbsstring

Native Google filter, such as qdr:w for the past week.

Example:qdr:w
safe'active' | 'off'

SafeSearch: active or off.

type'search'

Only search is accepted on this route.

engine'google'

Only google is accepted.

timeoutnumber

Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.

Request body

qstring required

Search query. Required, non-empty, at most 2,048 characters.

glstring

Lowercase two-letter country code.

hlstring

Language code, such as en or fr.

locationstring

Human-readable search location, up to 512 characters, using the native Google Search location rules.

numinteger

Integer from 1 to 10; caps the returned organic results.

pageinteger

Result page, starting at 1. Translates to native start=(page-1)*num.

autocorrectboolean

Set false to disable Google's spelling correction.

tbsstring

Native Google filter, such as qdr:w for the past week.

safe'active' | 'off'

SafeSearch: active or off.

type'search'

Only search is accepted on this route.

engine'google'

Only google is accepted.

Example request

{
  "q": "coffee brewing",
  "gl": "us",
  "hl": "en",
  "location": "Austin, Texas, United States",
  "num": 10,
  "page": 2,
  "tbs": "qdr:w"
}

Response

Serper-compatible web search results; one Litescrape call consumed.

organicobject[] required
credits1 required
answerBoxobject
knowledgeGraphobject
peopleAlsoAskobject[]
relatedSearchesobject[]
topStoriesobject[]

Example response

{
  "searchParameters": {
    "q": "coffee brewing",
    "gl": "us",
    "hl": "en",
    "location": "Austin, Texas, United States",
    "num": 10,
    "page": 2,
    "tbs": "qdr:w"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.