Making requests
curl -k -x ngrp.oxylabs.io:60000 "https://example.com"
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.
To utilize additional functionalities of Next-Gen Residential Proxies such as setting up proxy location or reusing the same IP for a few consecutive requests, please send additional headers with the request.
Here's the full list of supported functionalities and headers:

Additional functionalities

Parameter
Description
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
You can add your headers, such as User-Agent, or any other, instead of pre-generated ones.
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's 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.
X-Oxylabs-Parser-Type
Use this header to set the parser type. Currently, only the ecommerce-product (adaptive parser) value is supported.
X-Oxylabs-Parse
Set the value to 1 to enable parsing.

Code examples

cURL
Python
curl -k -v -x ngrp.oxylabs.io:60000 -U user:pass1 "https://ip.oxylabs.io"
import requests
from pprint import pprint
​
# Define proxy dict. Don't forget to put your real user and pass here as well.
proxies = {
'http': 'http://user:[email protected]:60000',
'https': 'http://user:[email protected]:60000',
}
​
response = requests.get(
'https://ip.oxylabs.io',
verify=False, # It is required to ignore certificate
proxies=proxies,
)
​
# Print result page to stdout
pprint(response.text)