Tunnel Proxy Service

Congratulations, you've found the most convenient tunnel proxy service across the web.

Our platform offers high-quality HTTP request tunnel proxy services that are ready to use out of the box. You can easily configure proxy types and country locations without any package restrictions.

Features

• No need to pre-purchase packages, no starting fees, just pay as you go.
• Unlike other proxy providers, we don't set a traffic expiration date since there's no need to pre-purchase packages.
• Supports various proxy types: data center proxies, residential proxies, and mobile proxies.
• Coverage includes over two hundred countries worldwide.
• Extremely easy to use.

Getting Started

Getting started is straightforward; using our tunnel proxy is as simple as making a regular HTTP request.

You need to make a POST request to our proxy API https://apiok.us/api/proxy/request.

Then, pass the necessary parameters like the url you want to request via JSON payload to the server.

The corresponding field descriptions are as follows:

Name	Type	Required	Default Value	Example	Explanation
apikey	string	true		idr_***	Platform's API Key
proxy_type	string	true		1	Proxy type: 1(data center proxies)、2(residential proxies)、3(mobile proxies)
proxy_country	string	false		US	The country where the IP is located. For all values, please refer to Country Code List
proxy_sid	string	false		abc123321	This parameter controls whether use the same IP during the session
url	string	true		https://google.com	Request url
method	string	true	GET		Only support GET、POST
headers	object	false		{"Cookie": "a=b"}	Request headers
params	object	false		{"id":"123"}	Query string params
data	object	false		{"id":"123"}	Request payload
verify	bool	false	true		Whether to verify the certificate
allow_redirects	bool	false	true		Whether to allow redirection
timeout	number	false	30		Maximum 60s, minimum 30s

TIP

In some scenarios, you may need to maintain the same IP across multiple requests within a single session to prevent automatic IP changes. You can achieve this by setting proxy_sid.

If proxy_sid is not passed or is an empty string, the IP will change randomly with each request.

Considering the unstable lifespan of IP proxies, it's advisable to limit the session duration to within 5 minutes to prevent potential failures.

To explain the relevant states of proxy requests, some custom parameters will be added to the returned headers:

Name	Explanation
x-idatariver-code	Returns 0 for successful requests, 1000 for processing exceptions, 1001 for parameter errors, and 1005 for insufficient credits.
x-idatariver-credits	Indicates the number of credits consumed for this request.
x-idatariver-msg	Describes the result of the request.

You can refer to this document for all country codes. For relatively obscure countries where there may not be enough available proxy IPs, the returned headers will include the following custom parameters:

{
  "x-idatariver-code": "1001",
  "x-idatariver-credits": "0",
  "x-idatariver-msg": "no available proxy",
}

Proxy Types Overview

By specifying proxy_type, you can choose from the following three types of proxies.

Data Center Proxy

Utilizes IP resources from data center facilities, offering the best value for performance.

Residential Proxy

Residential proxy networks consist of genuine IP addresses provided by Internet Service Providers (ISPs). These IPs are tied to physical locations, making them appear more legitimate and reducing the chances of IP blocking and CAPTCHA verifications.

Residential proxies are most suitable for use cases such as ad verification, comment monitoring, and travel information aggregation.

Additionally, residential proxies cover a wider range of geographical locations, allowing easier access to content specific to countries or cities.

Mobile Proxy

Mobile proxies include real IP addresses from mobile devices, such as smartphones or tablets accessing the internet through mobile data. In essence, mobile proxies make users appear as if they're connecting to the internet via mobile data networks while hiding their original IP addresses.

The primary purpose of Mobile Proxy IP is to ensure online anonymity by letting users directly use the IP address provided by the mobile operator. You can use mobile proxies for use cases like ad verification, comment monitoring, or market research.

使用示例

The following uses python’s requests library to demonstrate how to initiate a proxy request

GET Request

import requests

url = "https://apiok.us/api/proxy/request"
payload = {
  "apikey": "idr_***",
  "proxy_type": "1",
  "proxy_country": "us",
  "proxy_sid": "",
  "url": "https://api.vvhan.com/api/getIpInfo",
  "method": "GET",
  "headers": {
    "Cookie": "a=b",
  },
  "params": {
    "id": "123123"
  }
}

response = requests.post(url, json=payload, timeout=60)

print(response.text)

POST Request/json

import requests

url = "https://apiok.us/api/proxy/request"
payload = {
  "apikey": "idr_***",
  "proxy_type": "1",
  "proxy_country": "us",
  "proxy_sid": "",
  "url": "https://api.vvhan.com/api/getIpInfo",
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
  },
  "data": {
    "id": "123123"
  }
}

response = requests.post(url, json=payload, timeout=60)

print(response.text)

POST Request/form-data

import requests

url = "https://apiok.us/api/proxy/request"
payload = {
  "apikey": "idr_***",
  "proxy_type": "1",
  "proxy_country": "us",
  "proxy_sid": "",
  "url": "https://api.vvhan.com/api/getIpInfo",
  "method": "POST",
  "headers": {
    "Content-Type": "application/x-www-form-urlencoded",
  },
  "data": {
    "id": "123123"
  }
}

response = requests.post(url, json=payload, timeout=60)

print(response.text)

Billing rules

There are different pricing details for different proxy types.

Glossary

Name	Explanation
Traffic	Requested input traffic + output traffic
Unit Price	The fee charged when the traffic does not exceed 100KB
Traffic Price	When the traffic exceeds 100KB, the billing unit price for the excess traffic

计费公式

credits per request = unit price + traffic price

If traffic <= 100KB, then traffic price = 0, finally credits per request = unit price

If traffic > 100KB, then traffic price = (traffic-100KB) * traffic price

Price list

Proxy Type	Unit Price	Excess Traffic Price
Data Center Proxy	0.0002 Credits	2 Credits/GB
Residential Proxy	0.0012 Credits	12 Credits/GB
Mobile Proxy	0.0025 Credits	25 Credits/GB

The following are the credits consumed by different proxy types when the request traffic is 100KB and 200KB respectively.

Proxy Type	100KB	200KB
Data Center Proxy	0.0002 Credits	0.0002 + (200KB-100KB)* 2*10^-9 = 0.0004 Credits
Residential Proxy	0.0012 Credits	0.0012 + (200KB-100KB)* 12*10^-9 = 0.0024 Credits
Mobile Proxy	0.0025 Credits	0.0025 + (200KB-100KB)* 25*10^-9 = 0.005 Credits

Precautions

• For security reasons, we only open ports 80 and 443, and only support http and https request schemas.
• If the request fails due to the target website itself, such as 404 or other errors, fees will also be deducted.