Making Requests

The easiest way to start is to send a simple query without custom options. We will add all standard headers on our end, pick the fastest proxy, and deliver you the response body.

curl -k -x https://unblock.oxylabs.io:60000 \
-U 'USERNAME:PASSWORD' \
'https://ip.oxylabs.io/location'

If you are observing low success rates or retrieve empty content, please try adding additional "x-oxylabs-render: html" header with your request. More information about JavaScript rendering can be found here.

To utilize additional functionalities of Web Unblocker, such as setting up proxy location or reusing the same IP for a few consecutive requests, please send additional headers with the request.

For optimal website unblocking, Web Unblocker employs pre-defined cookies, headers, and sessions. Please refrain from sending any custom parameters commonly used for unblocking, as they may interfere with Web Unblocker’s ability to get quality data.

Here's the full list of supported functionalities and headers:

Additional functionalities

ParameterDescriptionLink to read more

X-Oxylabs-Session-Id

If you would like to reuse the same IP for multiple requests, add a session ID which can be a random string of characters.

X-Oxylabs-Geo-Location

To use an IP address from a specific location, specify a country or a city, for example, Germany. You can find supported geo-location values here.

Headers

If you want to send custom headers, use x-oxylabs-force-headers: 1 header when submitting your request.

Cookies

You can add your cookies, for example, Cookie: NID=1234567890, to your requests.

X-Oxylabs-Status-Code

If your target site returns a non-standard status code with a successful response, you can send the response status code, and our system will not retry the request.

X-Oxylabs-Render

If you would like to render JavaScript, use html to get a rendered HTML or png to get a screenshot of the page.

For more advanced code examples, refer to individual functionality pages linked in the table above.

Code examples

curl -k -x https://unblock.oxylabs.io:60000 \
-U 'USERNAME:PASSWORD' \
'https://ip.oxylabs.io/headers'

Last updated