Datacenter Proxy List API
Proxy List - Default Request
Returns the rotating datacenter proxy list available to your account.
With no optional filters, the backend uses output=json, type=rotating, protocol=both, and country=all.
Static proxies are not included in the default response. Request type=static explicitly when you need the account-specific static proxy file.
Rate
Maximum 10 requests every 60 seconds
Note
All authentication and filter values belong in the URL query string. Do not send a JSON body with this GET request.
The API key may alternatively be sent in the X-API-Key header.
Required parameters
apiKey
Endpoint details
Query parameter contract
apiKey - required
Customer API key. Send it as the case-sensitive apiKey query parameter. The X-API-Key header is also accepted.
output / format - optional
Accepted values: json or plain. The default is json. format is supported as an alias, but output is the canonical parameter.
type - optional
Accepted values: rotating or static. The default is rotating.
protocol - optional
Accepted values: http, https, socks5, or both. The default is both. Selecting https returns the HTTP/S entries with protocol reported as http.
country - optional
Accepted values: world, eu, us, or all. The default is all. Values are case-insensitive.
Response contract
JSON success
Returns success, message, proxy_amount, and data. Each item contains address, host, port, type, class, protocol, and country.
Static JSON additions
Static proxy items additionally include origin_ip and continent.
Plain-text success
Returns one host:port address per line with Content-Type text/plain. The X-Proxy-Amount response header contains the number of returned entries.
No matching proxies
Returns HTTP 200 as JSON even when output=plain: { "success": false, "proxy_amount": 0, "message": "No proxies found matching your criteria.", "data": [] }
Possible API responses
400 Bad Request
Missing API key or invalid output, type, protocol, or country value.
401 Unauthorized
The supplied customer API key does not match a user.
403 Forbidden
The account is inactive, has no usable datacenter subscription, or has no concurrency assigned.
429 Too Many Requests
The endpoint rate limit was exceeded. Use the Retry-After response header.
500 Internal Server Error
The database, rotating proxy configuration, or static proxy file could not be processed.
Python • requests
import json
import requests
endpoint = "https://proxytitan.com/api/v1.0/datacenter/proxies"
api_key = "xxx"
params = {
"apiKey": api_key,
}
response = requests.get(
endpoint,
params=params,
timeout=30
)
print("Status:", response.status_code)
print("Content-Type:", response.headers.get("content-type"))
try:
print(json.dumps(response.json(), indent=2))
except requests.exceptions.JSONDecodeError:
print(response.text)
Replace xxx with your customer API key. Filters belong in the query string, not in a GET request body.
Response (JSON)
Show example response
Click to reveal the response structure.
Example rotating response. The actual amount, hosts, ports, and countries depend on the configured rotating definitions.
Output: plain
Set output=plain to return one proxy address per line.
The backend also accepts format=plain as a compatibility alias.
Plain output contains only address values. Metadata remains available only in JSON output.
Rate
Maximum 10 requests every 60 seconds
Note
A successful plain response includes the X-Proxy-Amount header.
A no-match response is still returned as JSON with success=false.
Required parameters
apiKey
Endpoint details
Filters used in this example
output=plain
Query parameter contract
apiKey - required
Customer API key. Send it as the case-sensitive apiKey query parameter. The X-API-Key header is also accepted.
output / format - optional
Accepted values: json or plain. The default is json. format is supported as an alias, but output is the canonical parameter.
type - optional
Accepted values: rotating or static. The default is rotating.
protocol - optional
Accepted values: http, https, socks5, or both. The default is both. Selecting https returns the HTTP/S entries with protocol reported as http.
country - optional
Accepted values: world, eu, us, or all. The default is all. Values are case-insensitive.
Response contract
JSON success
Returns success, message, proxy_amount, and data. Each item contains address, host, port, type, class, protocol, and country.
Static JSON additions
Static proxy items additionally include origin_ip and continent.
Plain-text success
Returns one host:port address per line with Content-Type text/plain. The X-Proxy-Amount response header contains the number of returned entries.
No matching proxies
Returns HTTP 200 as JSON even when output=plain: { "success": false, "proxy_amount": 0, "message": "No proxies found matching your criteria.", "data": [] }
Possible API responses
400 Bad Request
Missing API key or invalid output, type, protocol, or country value.
401 Unauthorized
The supplied customer API key does not match a user.
403 Forbidden
The account is inactive, has no usable datacenter subscription, or has no concurrency assigned.
429 Too Many Requests
The endpoint rate limit was exceeded. Use the Retry-After response header.
500 Internal Server Error
The database, rotating proxy configuration, or static proxy file could not be processed.
Python • requests
import json
import requests
endpoint = "https://proxytitan.com/api/v1.0/datacenter/proxies"
api_key = "xxx"
params = {
"apiKey": api_key,
"output": "plain",
}
response = requests.get(
endpoint,
params=params,
timeout=30
)
print("Status:", response.status_code)
print("Content-Type:", response.headers.get("content-type"))
try:
print(json.dumps(response.json(), indent=2))
except requests.exceptions.JSONDecodeError:
print(response.text)
Replace xxx with your customer API key. Filters belong in the query string, not in a GET request body.
Response (Plain Text)
Show example response
Click to reveal the response structure.
Plain-text output contains one host:port entry per line.
Protocol: socks5
Set protocol=socks5 to return only SOCKS5 entries.
Supported protocol values are http, https, socks5, and both.
The default protocol is both.
Rate
Maximum 10 requests every 60 seconds
Note
The https selector uses the same HTTP/S proxy entries as http. Returned JSON reports those entries as protocol=http.
Required parameters
apiKey
Endpoint details
Filters used in this example
protocol=socks5
Query parameter contract
apiKey - required
Customer API key. Send it as the case-sensitive apiKey query parameter. The X-API-Key header is also accepted.
output / format - optional
Accepted values: json or plain. The default is json. format is supported as an alias, but output is the canonical parameter.
type - optional
Accepted values: rotating or static. The default is rotating.
protocol - optional
Accepted values: http, https, socks5, or both. The default is both. Selecting https returns the HTTP/S entries with protocol reported as http.
country - optional
Accepted values: world, eu, us, or all. The default is all. Values are case-insensitive.
Response contract
JSON success
Returns success, message, proxy_amount, and data. Each item contains address, host, port, type, class, protocol, and country.
Static JSON additions
Static proxy items additionally include origin_ip and continent.
Plain-text success
Returns one host:port address per line with Content-Type text/plain. The X-Proxy-Amount response header contains the number of returned entries.
No matching proxies
Returns HTTP 200 as JSON even when output=plain: { "success": false, "proxy_amount": 0, "message": "No proxies found matching your criteria.", "data": [] }
Possible API responses
400 Bad Request
Missing API key or invalid output, type, protocol, or country value.
401 Unauthorized
The supplied customer API key does not match a user.
403 Forbidden
The account is inactive, has no usable datacenter subscription, or has no concurrency assigned.
429 Too Many Requests
The endpoint rate limit was exceeded. Use the Retry-After response header.
500 Internal Server Error
The database, rotating proxy configuration, or static proxy file could not be processed.
Python • requests
import json
import requests
endpoint = "https://proxytitan.com/api/v1.0/datacenter/proxies"
api_key = "xxx"
params = {
"apiKey": api_key,
"protocol": "socks5",
}
response = requests.get(
endpoint,
params=params,
timeout=30
)
print("Status:", response.status_code)
print("Content-Type:", response.headers.get("content-type"))
try:
print(json.dumps(response.json(), indent=2))
except requests.exceptions.JSONDecodeError:
print(response.text)
Replace xxx with your customer API key. Filters belong in the query string, not in a GET request body.
Response (JSON)
Show example response
Click to reveal the response structure.
Every returned item has protocol=socks5 for this request.
Country: us
Set country=us to return proxies from the US rotating definition.
Supported selectors are world, eu, us, and all.
The default selector is all.
Rate
Maximum 10 requests every 60 seconds
Note
Country selectors are case-insensitive.
The country string returned in each item preserves the value stored in the proxy definition.
Required parameters
apiKey
Endpoint details
Filters used in this example
country=us
Query parameter contract
apiKey - required
Customer API key. Send it as the case-sensitive apiKey query parameter. The X-API-Key header is also accepted.
output / format - optional
Accepted values: json or plain. The default is json. format is supported as an alias, but output is the canonical parameter.
type - optional
Accepted values: rotating or static. The default is rotating.
protocol - optional
Accepted values: http, https, socks5, or both. The default is both. Selecting https returns the HTTP/S entries with protocol reported as http.
country - optional
Accepted values: world, eu, us, or all. The default is all. Values are case-insensitive.
Response contract
JSON success
Returns success, message, proxy_amount, and data. Each item contains address, host, port, type, class, protocol, and country.
Static JSON additions
Static proxy items additionally include origin_ip and continent.
Plain-text success
Returns one host:port address per line with Content-Type text/plain. The X-Proxy-Amount response header contains the number of returned entries.
No matching proxies
Returns HTTP 200 as JSON even when output=plain: { "success": false, "proxy_amount": 0, "message": "No proxies found matching your criteria.", "data": [] }
Possible API responses
400 Bad Request
Missing API key or invalid output, type, protocol, or country value.
401 Unauthorized
The supplied customer API key does not match a user.
403 Forbidden
The account is inactive, has no usable datacenter subscription, or has no concurrency assigned.
429 Too Many Requests
The endpoint rate limit was exceeded. Use the Retry-After response header.
500 Internal Server Error
The database, rotating proxy configuration, or static proxy file could not be processed.
Python • requests
import json
import requests
endpoint = "https://proxytitan.com/api/v1.0/datacenter/proxies"
api_key = "xxx"
params = {
"apiKey": api_key,
"country": "us",
}
response = requests.get(
endpoint,
params=params,
timeout=30
)
print("Status:", response.status_code)
print("Content-Type:", response.headers.get("content-type"))
try:
print(json.dumps(response.json(), indent=2))
except requests.exceptions.JSONDecodeError:
print(response.text)
Replace xxx with your customer API key. Filters belong in the query string, not in a GET request body.
Response (JSON)
Show example response
Click to reveal the response structure.
Example US rotating response. Addresses and ports are illustrative.
Type: static - SOCKS5 plain example
Set type=static to load the customer-specific static proxy file.
This example combines type=static, protocol=socks5, and output=plain.
The returned amount is based on the valid matching entries in the account proxy file; it is not hard-coded by this endpoint.
Rate
Maximum 10 requests every 60 seconds
Note
Static access requires an available proxy file for the authenticated account.
When requested as JSON, static items additionally contain origin_ip and continent.
Required parameters
apiKey
Endpoint details
Filters used in this example
type=static protocol=socks5 output=plain
Query parameter contract
apiKey - required
Customer API key. Send it as the case-sensitive apiKey query parameter. The X-API-Key header is also accepted.
output / format - optional
Accepted values: json or plain. The default is json. format is supported as an alias, but output is the canonical parameter.
type - optional
Accepted values: rotating or static. The default is rotating.
protocol - optional
Accepted values: http, https, socks5, or both. The default is both. Selecting https returns the HTTP/S entries with protocol reported as http.
country - optional
Accepted values: world, eu, us, or all. The default is all. Values are case-insensitive.
Response contract
JSON success
Returns success, message, proxy_amount, and data. Each item contains address, host, port, type, class, protocol, and country.
Static JSON additions
Static proxy items additionally include origin_ip and continent.
Plain-text success
Returns one host:port address per line with Content-Type text/plain. The X-Proxy-Amount response header contains the number of returned entries.
No matching proxies
Returns HTTP 200 as JSON even when output=plain: { "success": false, "proxy_amount": 0, "message": "No proxies found matching your criteria.", "data": [] }
Possible API responses
400 Bad Request
Missing API key or invalid output, type, protocol, or country value.
401 Unauthorized
The supplied customer API key does not match a user.
403 Forbidden
The account is inactive, has no usable datacenter subscription, or has no concurrency assigned.
404 Not Found
No static proxy file is available for the account.
429 Too Many Requests
The endpoint rate limit was exceeded. Use the Retry-After response header.
500 Internal Server Error
The database, rotating proxy configuration, or static proxy file could not be processed.
Python • requests
import json
import requests
endpoint = "https://proxytitan.com/api/v1.0/datacenter/proxies"
api_key = "xxx"
params = {
"apiKey": api_key,
"type": "static",
"protocol": "socks5",
"output": "plain",
}
response = requests.get(
endpoint,
params=params,
timeout=30
)
print("Status:", response.status_code)
print("Content-Type:", response.headers.get("content-type"))
try:
print(json.dumps(response.json(), indent=2))
except requests.exceptions.JSONDecodeError:
print(response.text)
Replace xxx with your customer API key. Filters belong in the query string, not in a GET request body.
Response (Plain Text)
Show example response
Click to reveal the response structure.
Example static SOCKS5 addresses. The actual allocation belongs to the authenticated account.