Parameters

url or query

n/a

null

Mandatory. Some target templates support query parameter, otherwise url is required.

https://ip.decodo.com

url

target

n/a

null

Necessary for some specific target templates

google_search

n/a

headless

X-Decodo-Headless

null

Enable JavaScript rendering. Supported: – html – png

html

n/a

geo

X-Decodo-Geo

auto-randomized

The geographical location on which the result depends. Read more.

United States

US, CA, GB, DE, FR, NL, JP, RO

locale

n/a

Matched with domain parameter

This will change the search page web interface language (not the results). Example: – en-US – en-GB

en-gb

n/a

markdown

n/a

false

Parses HTML output into Markdown. Results in less tokens when feeding results into LLM models.

true

n/a

headers

n/a

null

Adds request headers to the target request.

User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36

n/a

cookies

n/a

null

Client cookie. Allows users to open up pages as if they are logged in.

Cookie: sessionid=8e1f3b56-7abc-47e6-b2e2-1d273b0a1c4d; logged_in=true; locale=en-US

n/a

force_cookies

n/a

false

By default, user-provided cookies are not forwarded to the target. Set this parameter to true to override this behaviour.

true

n/a

force_headers

n/a

false

By default, user-provided headers are not forwarded to the target. Set this parameter to true to override this behaviour.

true

n/a

domain

n/a

com

com, co.uk, fr, etc.

com

n/a

device_type

X-Decodo-Device-Type

desktop

Device type and browser. Supported: – desktop – desktop_chrome – desktop_firefox – mobile – mobile_android – mobile_ios

desktop

n/a

parse

X-Decodo-Parse

false

When 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, so you have the choice to do the parsing on your end.

true

HTML

session_id

n/a

null

Session to re-use the same IP for multiple requests for up to 10 minutes

1234

n/a

http_method

n/a

GET

Used to make a POST request instead of GET.

POST

✅

payload

n/a

null

Base64 encoded POST request body. Used when http_method is POST.

{foo: bar}

✅

successful_status_codes

n/a

null

Define one or more HTTP response codes you consider successful and want to get the content for.

401, 404

✅