Google SERP Scraper

Creating a Google SERP Scraping Task

Submit a Google SERP scraping task to retrieve organic search results for a given query.

Requires the serp:google scope on your API key.

Endpoint

POST /api/parsing/v1/serp-google

Request Body

Name	Type	Required	Description
q	string	yes	Search query
count	number	yes	Number of results to fetch (min: `10`, max: `100`)
hl	string	no	Results language code (e.g. `en`, `ru`)
gl	string	no	Country code for search results (e.g. `us`, `ru`) — see Available countries
canonicalLocationName	string	no	Location for localized results (e.g. `New York,New York,United States`) — see Available cities
isDesktop	boolean	no	Emulate desktop browser (default: `true`)
aiOverview	boolean	no	Parse Google AI Overview (default: `false`)
callbackUrl	string	no	Webhook URL to POST result when done
useragent	string	no	Custom User-Agent string (printable ASCII only)
screenResolution	string	no	Browser screen resolution (e.g. `1920x1080`, `360x640`)
parsingDomain	string	no	Custom search domain (e.g. `google.de`)
takeScreenshot	boolean	no	Capture a screenshot of the page (default: `false`)
params	array of records	no	Pass custom search params (e.g. `[{"key": "tbs", "value": "qdr:m"}]`)

Example Request

curl https://app.scrapering.com/api/parsing/v1/serp-google \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
  "q": "Buy pizza",
  "hl": "en",
  "gl": "us",
  "canonicalLocationName": "New York,New York,United States",
  "count": 10,
  "isDesktop": false
}'

Example Response

{
  "id": "abaf4ac3-d9e7-43f2-a414-e7d2ca9ff635",
  "status": "parsing",
  "scope": "serp:google",
  "costCredits": 1,
  "createdAt": "2026-03-20T12:48:05.935Z"
}

The task is processed asynchronously. Use the id to poll for the result or set callbackUrl to receive a webhook when parsing completes.

Next steps

Receiving result — poll for the result using the task ID
Webhook — receive the result via callback instead of polling
Available countries — look up gl country codes for geo-targeting
Available cities — look up canonicalLocationName values for city-level targeting
Pricing — see how credits are calculated for SERP requests