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. Use a full country name in Capital Case (United States) or an uppercase 2-letter code (US). 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. Send them as an object. | {"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"} | |
cookies | null | Cookies to send to the target website, for example to set a currency or language preference. Send them as an array of objects with key and value. | [{"key": "currency", "value": "USD"}] | |
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. | eyJmb28iOiAiYmFyIn0= ({"foo": "bar"} encoded) | |
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 | |
main_content | false | Returns only the main content of the page in the Markdown output, without navigation, headers, footers and sidebars. Works only with markdown: true on real-time requests and universal target. | 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.