Note that supported parameters may vary slightly depending on the target template. Read more.
| Parameter | Default value | Description | Example |
|---|---|---|---|
proxy_pool | premium | standard handles simple pages; Premium resolves complex anti-bot measures and used for Target Templates | standard |
url or query | null | Mandatory. Some target templates support query parameter, otherwise url is required. | https://ip.decodo.com |
target | null | Necessary for specific target templates | google_search |
headless | nullSome target templates force JS rendering by default | html value enables JavaScript rendering. Read more. png value enables screenshot response. Read more. | html |
geo | auto-randomized | The geographical location on which the result depends. Read more. | United States |
domain | com | Specify top-level domain: com, co.uk, fr, etc. | com |
locale | Matched with domain parameter | This will change the search page web interface language (not the results). Example: – en-US – en-GB | en-gb |
headers | 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/<IP_ADDRESS> Safari/537.36 |
cookies | 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 |
force_cookies | false | By default, user-provided cookies are not forwarded to the target. Set this parameter to true to override this behaviour. | true |
force_headers | false | By default, user-provided headers are not forwarded to the target. Set this parameter to true to override this behaviour. | true |
device_type | desktop | Device type and browser. Read more. | desktop |
parse | false | For certain target templates dedicated parsers are available. To retrieve structured data, set parse parameter to true. Read more. | true |
session_id | null | Session to re-use the same IP for multiple requests for up to 10 minutes | 1234 |
http_method | GET | Used to make a POST request instead of GET. | POST |
payload | null | Base64 encoded POST request body. Used when http_method is POST. | {foo: bar} |
successful_status_codes | null | Define one or more HTTP response codes you consider successful and want to get the content for. | 401, 404 |
markdown | false | Parses HTML output into Markdown. Results in less tokens when feeding results into LLM models. Read more. | true |
xhr | false | Retrieves a list of XHR and fetch requests.Read more. | true |
Support
Need help or just want to say hello? Our support is available 24/7.
You can also reach us anytime via email at support@decodo.com.
You can also reach us anytime via email at support@decodo.com.
Feedback
Can’t find what you’re looking for? Request an article!
Have feedback? Share your thoughts on how we can improve.
Have feedback? Share your thoughts on how we can improve.