UAPI

UAPI (Unified API) is a standalone product that brings together all of Netnut's tools and intelligently chooses which product to use for the URL you provide.

Saving your spend

Let's look at a simple scenario. You need to scrape a specific page from the web, and you plan to use Unblocker for that URL to make sure it is scraped properly.

When you use UAPI, the system automatically checks previous attempts for that webpage. Based on its knowledge base, it may determine that a DC IP is enough to access the page.

This helps you reduce costs on every request by always choosing the cheapest option that can still deliver the best result for each page you request.

What's included

Here is a list of the products that are already part of UAPI:

• Data Center IPs

• ISP IPs

• Residential IPs

• Unblocker

• Unblocker with JavaScript Rendering

• SERP (search engines API)

Very soon, we're going to add the following products:

• LLM Scrapers

• LinkedIn API

Only pay for the value

The billing model is straightforward. You pay only for the requests and products that successfully return the data you need. For example:

dc: failed
isp: failed
resi: success

In this case, you pay for only one request under the Residential IP product. All other requests are free of charge because they did not provide the value you requested.

Extract API

POST /v1/extract

Headers

Header	Required	Description
Content-Type: application/json	yes	Request body format
X-API-Token	yes	Unified API client token
clean_html	no	Boolean header. Enables HTML cleanup before formatting

Request Body

{
  "url": "https://example.com",
  "formats": 
    [
      "markdown|html|json"
    ],
  "country_code": "us",
}

Fields

Field	Type	Required	Description
url	URL string	yes	Target URL to extract
formats	string	no	Output formats. Supported: html, markdown, json
country_code	string	no	Two-letter country code, e.g. us, gb, de

If formats is omitted, the default is:

["markdown"]

Response Format

/v1/extract returns raw content directly, not a JSON envelope.

Possible response types:

• text/html for HTML

• text/markdown for Markdown

• application/json for SERP JSON

• text/plain for user-facing failures

Every response includes:

X-Request-Id: <request_id>

Example Request

curl -i --location 'https://uapi.netnut.io/v1/extract' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'X-API-Token: <api-token>' \
  --header 'clean_html: true' \
  --data '{
    "url": "https://www.example.com/example-product",
    "formats": ["markdown"],
    "country_code": "us"
  }'