Custom Parameters

NetNut’s Website Unblocker supports multiple functionalities and headers for customized requests.

Geolocation

Access content as if you are in different geographical locations, for tailored and localized web scraping unblock capabilities.

Request specific country name in the x-netnut-geo-location header.

For instance, to simulate accessing a website from France, add "x-netnut-geo-location:FR" to your request, as in the example below:

curl -k -x username:[email protected]:5959 -H "x-netnut-geo-location:FR" https://website-to-unblock.com

Dynamic Page Rendering

For scenarios where you need the rendered HTML of a web page, use the x-netnut-html-render: true in your request.

curl -k -x username:[email protected]:5959 -H "x-netnut-html-render:true" https://website-to-unblock.com

Sticky Session

Maintain a persistent session by keeping the same IP address across multiple requests. Request a specific session ID in the x-netnut-sid header.

For instance, to simulate accessing a website with the same IP for paginated navigation, add x-netnut-sid:123456789 to your request, as in the example below:

curl -k -x username:[email protected]:5959 \
  -H "x-netnut-sid:123456789" \
  https://website-to-unblock.com

x-netnut-sid: Accepts numeric values only (0–9). Requests that use the same sid will reuse the same IP until the session ends naturally or the sid is changed.

• We recommend using a 9-digit sid for better stickiness and consistency.

If not provided, the request will default to normal IP rotation.

Format

Control the format of the response using the x-netnut-format header.

curl -k -x username:[email protected]:5959 \
  -H "x-netnut-format:raw" \
  https://httpbin.org/json

• x-netnut-format:

  • html → returns HTML (default).

  • raw → returns the original format served by the URL (HTML if the page is HTML, JSON if the endpoint serves JSON).

Use Case: Use raw when scraping API endpoints or structured data sources where JSON is expected instead of HTML.