Parameters

All Scraper APIs support the parameters listed in this page. Note that each individual target may have custom parameters.

ParameterHeader nameDefault valueDescriptionExample
targetn/aEach 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.
google_search
headlessX-Smartproxy-HeadlessnullEnable JavaScript rendering.
Supported:
– html
– png
html
geoX-Smartproxy-Geoauto-randomizedThe 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.
United States
localen/aMatched with domain parameterThis will change the search page web interface language (not the results).
Example:
– en-US
– en-GB
en-gb
headersn/anullAdds requests headers to the target request.
cookiesn/anullClient cookie. Allows opening up pages as if the user is logged in.
force_cookiesn/afalseBy default, user-provided cookies are not forwarded to the target. Set this parameter to true to override this behaviour.true
force_headersn/afalseBy default, user-provided headers are not forwarded to the target. Set this parameter to true to override this behaviour.true
domainn/acomcom, co.uk, fr, etc.com
device_typeX-Smartproxy-Device-TypedesktopDevice type and browser.
Supported:
– desktop
– desktop_chrome
– desktop_firefox
– mobile
– mobile_android
– mobile_ios
desktop
parseX-Smartproxy-ParsefalseWhen set to true, if the selected target supports parsing, we will parse the result on our end using our selectors. This will, however, omit some information out, so you have the choice to do the parsing on your end.true
session_idn/aSession to re-use the same IP for multiple requests for up to 10 minutes1234
http_methodn/aUsed to make a POST request instead of GETPOST
payloadn/aBase64 encoded POST request body. Used when http_method is POST.{foo: bar}
successful_status_codesn/aDefine one or more HTTP response codes you consider successful and want to get the content for.401, 404