Start using Web Unblocker

Create an API user

Start by registering an account on the Oxylabs dashboard. Purchase a pricing plan or opt for a free trial. Then, create an API user with custom credentials.

Make a cURL request

You can use this cURL code sample for testing:

curl 'https://sandbox.oxylabs.io/products/' -U 'USERNAME:PASSWORD' -x 'unblock.oxylabs.io:60000' -H 'x-oxylabs-geo-location: United States' -k

Change the USERNAME and PASSWORD to the API user credentials you’ve just created, paste the code into your terminal (or any other setup), and run the command. This will send a basic request to sandbox.oxylabs.io/products using a random IP address from the United States.

Check out this video for a quick overview:

​Location and session parameters

If you want to make requests through a proxy server located in a specific country, refer to this Geo-location page in our documentation. ​

For Amazon and Google targets, you should use different targeting options. All the geo-targeting settings are free of charge.

In case you need to control your session time for a particular IP address, you can find all the information on this Session page.

Using headless browser

To enable JavaScript rendering of a page via the headless browser feature, you must include the "X-Oxylabs-Render: html" with your requests.

When a target website requires specific browser actions to access data, such as clicking elements, inputting text, or scrolling pages, you can utilize browser instructions.


Last updated

Was this helpful?