Unblocker Features

NetNut’s Website Unblocker API allows users to enhance requests with two powerful parameters: geolocation targeting and JavaScript rendering. These options help simulate user behavior from specific regions and interact with dynamic websites.

Geolocation (country)

You can route your request through a specific geographic location by setting the country parameter in the request body. This allows localized access, enabling you to scrape region-specific content such as pricing, languages, or availability.

Example

{
  "url": "https://example.com",
  "country": "fr"
}
  • country: Accepts standard country codes (e.g., "us", "fr", "uk").

  • If not provided, the request will default to the US.

Use Case

Use this when scraping pages that return different content based on region — for example, eCommerce pricing, local search results, or region-restricted data.


JavaScript Rendering (js_render)

Some websites use JavaScript to load critical content. To capture this dynamic content, you can enable dynamic rendering using the js_render option.

Example

{
  "url": "https://example.com",
  "js_render": true
}
  • js_render: Boolean (defaults to false).

  • When set to true, the page will be rendered in a headless browser to include dynamic JavaScript-based content.

Use Case

Enable this when:

  • Content does not appear in the raw HTML

  • Data is dynamically loaded via JavaScript (e.g., React/Angular-based apps)

  • You need the final, fully rendered DOM


Sticky Session (sid)

You can keep the same IP address across multiple requests by setting the sid parameter in the request body . This allows you to maintain session persistence for multi-step workflows such as paginated navigation or repeated requests to the same domain.

Example

{
  "url": "https://example.com",
  "sid": "987654321"
}

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.

  • Navigating through paginated or infinite-scroll results.

  • Repeatedly scraping the same domain where consistent IP helps reduce bot-detection triggers.

Use Case Use this when performing multi-step actions that require the same IP — for example:


Page Format (format)

By default, Unblocker returns responses in HTML. If you want the raw JSON response directly from the website, you can set the format parameter to raw.

Example

{
  "url": "https://httpbin.org/json",
  "format": "raw"
}

format:

  • Defaults to HTML (no param).

  • "raw" returns the unmodified JSON response directly from the site.

Use Case Use this when scraping APIs or endpoints that serve JSON data, such as product APIs, metadata endpoints, or structured feeds.


Combined Example

{
  "url": "https://example.com",
  "country": "fr",
  "js_render": true,
  "sid": "987654321",
  "format": "raw"
}

This request:

  • Routes through France

  • Loads the fully rendered HTML using JavaScript execution

  • Maintains the same IP session across multiple requests

  • Returns the response in raw JSON format

Last updated