API Integration (NEW)

The Website Unblocker API allows you to retrieve public web content through a simple HTTP endpoint without managing proxy infrastructure directly. It is designed to provide an accessible alternative to our proxy-based integration while retaining the same anti-bot capabilities, support for dynamic pages, and flexible request customization.

Key Features

Direct HTTP POST interface with JSON body
No proxy string required
Optional JavaScript rendering for dynamic pages
Optional geolocation
Works with your existing NetNut credentials via Basic Auth

API Setup

Endpoint

https://unblocker.netnut.io/unblock

Authentication

Use HTTP Basic Authentication:

Authorization: Basic base64(username:password)

Request Body Schema

{
  "url": "https://example.com",     // Required
  "country": "us",                  // Optional
  "js_render": false,               // Optional, default is false
  "sid": "987654321",               // Optional
  "format": "html",                 // Optional, default is "html"
  "method": "GET"                   // Optional, default is "GET"
}

url: The target page to fetch. (Required)
country: Country geolocation for the request (us - United States, uk - United Kingdom, fr - France). Default country is dynamically chosen for each URL. (Optional)
js_render: Set to true to enable JavaScript rendering for dynamic content. Boolean type. Defaults to false. (Optional)
⚡ Note: We recommend keeping js_render disabled (false) unless the site requires it. Using false avoids unnecessary rendering; enable only when needed for dynamic content.
sid: Maintain a sticky session by reusing the same IP across multiple requests. Accepts numeric values only (0–9). Recommended: 9-digit number for best stickiness. (Optional)
format: Controls the response 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). (Optional)
method: HTTP method. Currently only supported value is GET. (Optional)

Example Usage

curl -X POST https://unblocker.netnut.io/unblock \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic base64(username:password)" \
  -d '{
    "url": "https://example.com",
    "country": "fr",
    "format": "raw",
    "js_render": true,
    "sid":"987654321"
  }'

from base64 import b64encode

headers = {
    "Authorization": "Basic " + b64encode(b"username:password").decode(),
    "Content-Type": "application/json"
}

body = {
    "url": "https://example.com",
    "country": "us",
    "format": "raw",
    "js_render": False,
}

response = requests.post("https://unblocker.netnut.io/unblock", headers=headers, json=body)
print(response.text)

const username = 'your_username';
const password = 'your_password';
const auth = Buffer.from(`${username}:${password}`).toString('base64');

const headers = {
  'Authorization': `Basic ${auth}`,
  'Content-Type': 'application/json'
};

const body = {
  url: 'https://example.com',
  country: 'us',
  format: 'raw',
  js_render: false
};

fetch('https://unblocker.netnut.io/unblock', {
  method: 'POST',
  headers: headers,
  body: JSON.stringify(body)
})
.then(response => {
  if (!response.ok) throw new Error(`HTTP error ${response.status}`);
  return response.text(); // or use .json() if expecting JSON
})
.then(data => {
  console.log(data);
})
.catch(error => {
  console.error('Error:', error.message);
});

Response Format

HTML (Default)

<!DOCTYPE html>
<html>
<head>...</head>
<body>...</body>
</html>

PreviousIntroduction to Website Unblocker NextUnblocker Features

Last updated 10 days ago