Skip to main content
All CollectionsGetting Started
How to start using Web Unblocker
How to start using Web Unblocker
Josh avatar
Written by Josh
Updated over 5 months ago

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.


🙌 Need assistance? Contact support via live chat or send a message to [email protected].

🎯 Want a custom solution or a free trial? Contact sales by booking a call. For any questions, such as custom pricing, advice, or a free trial, drop us a line at [email protected].

Did this answer your question?