Parameters

All Scraper APIs support the following parameters

ParameterDefault valueDescription
targetgoogle_searchEach Scraping API supports a number of targets. This parameter is always required, along with either url or query.

See targets supported by SERP Scraping APIs for examples.
urlDirect URL (link) to a page you want to scrape.
queryA query used for the specific target.
geoThe geographical location that the result depends on.

– City location names
– State names
– Country names
– Coordinates and Radius
– Google’s Canonical
– Location Name. Read more here.
localeMatched with domain parameterThis will change the search page web interface language (not the results).
Example:
– en-US
– en-GB
headersAdds requests headers to the target request.
cookiesClient cookie. Allows opening up pages as if the user is logged in.
force_cookiesBy default, user-provided cookies are not forwarded to the target. Set this parameter to true to override this behaviour.
domaincomcom, co.uk, fr, etc.
device_typedesktopDevice type and browser.
Supported:
– desktop
– desktop_chrome
– desktop_firefox
– mobile
– mobile_android
– mobile_ios
parsefalse'true' will return parsed output in JSON format. Leave blank for HTML – not all data sources can be parsed.
headlessEnable JavaScript rendering.
Supported:
– html
– png
session_idSession to re-use the same IP for multiple requests for up to 10 minutes
http_methodUsed to make a POST request instead of GET
payloadBase64 encoded POST request body. Used when http_method is POST.
successful_status_codesDefine one or more HTTP response codes you consider successful and want to get the content for.