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
  "format": "raw",                       // Optional, default is "raw"
  "method": "GET",                       // Optional, default is "GET"
  "js_render": false                     // Optional, default is false
}

url: The target page to fetch.
country: Country geolocation for the request (us - United States, uk -United Kingdom ,fr - France). Default country is dynamically chosen for each URL.
format: raw for HTML.
method: Only supported value is GET .
js_render: Set to true to enable JavaScript rendering. Boolean type.

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,
  }'

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 24 days ago