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:


Combined Example

{
  "url": "https://example.com",
  "country": "fr",
  "js_render": true
}

This request:

  • Routes through France

  • Loads the fully rendered HTML using JavaScript execution

Last updated