Documentation
Start for free
API reference

Proxy list

Retrieve rotating datacenter endpoints by authentication method, protocol, region, output format, and number of ports.

IP-authenticated proxy list

GET /api/v1.0/datacenter/proxies

Returns proxy endpoints that accept connections from an IP address already added to your whitelist.

IP-authenticated entries use the host:port format.

Rate limit10 requests / 60 seconds
ParametersX-API-Key header, authentication=ip_authentication, protocol=http, amount=2, output=json
Endpoint details
FormatEach address is returned as host:port.
Whitelist requiredThe requesting account must whitelist its connecting IPv4 address before using these endpoints.
Authentication valueUse authentication=ip_authentication. The aliases ip, ip_auth and ip-auth are also accepted.
Port sourceOnly active proxies collection documents matching IP authentication and the selected protocol are used.
Request · Python requests
import requests

params = {
    "authentication": "ip_authentication",
    "protocol": "http",
    "amount": "2",
    "output": "json",
}

response = requests.get(
    "https://rotatingproxyhub.com/api/v1.0/datacenter/proxies",
    headers={"X-API-Key": "xxx"},
    params=params,
    timeout=30
)

print(response.text)
Example response
{
  "success": true,
  "message": "Rotating proxy list retrieved successfully.",
  "proxy_amount": 2,
  "authentication": "ip_authentication",
  "amount_per_document": 2,
  "data": [
    {
      "address": "51.15.21.75:20000",
      "host": "51.15.21.75",
      "port": 20000,
      "type": "rotating",
      "class": "datacenter",
      "protocol": "http",
      "country": "World",
      "region_code": "world",
      "authentication": "ip_authentication",
      "authentication_label": "IP Authentication"
    },
    {
      "address": "51.15.21.75:20001",
      "host": "51.15.21.75",
      "port": 20001,
      "type": "rotating",
      "class": "datacenter",
      "protocol": "http",
      "country": "World",
      "region_code": "world",
      "authentication": "ip_authentication",
      "authentication_label": "IP Authentication"
    }
  ]
}

Username/password proxy list

GET /api/v1.0/datacenter/proxies

Returns endpoints with the account proxy username and password appended to every entry.

Plain output contains one host:port:user:pass entry per line.

Rate limit10 requests / 60 seconds
ParametersX-API-Key header, authentication=user_pass_authentication, protocol=http, amount=3, output=plain
Endpoint details
FormatEach address is returned as host:port:username:password.
Allowed rolesUsername/password output is available only to customer and trial accounts.
CredentialsThe API reads proxy_configuration.proxy_credentials from the authenticated profile.
Sensitive outputThe response is marked no-store. Do not log or publicly expose generated proxy lists.
Request · Python requests
import requests

params = {
    "authentication": "user_pass_authentication",
    "protocol": "http",
    "amount": "3",
    "output": "plain",
}

response = requests.get(
    "https://rotatingproxyhub.com/api/v1.0/datacenter/proxies",
    headers={"X-API-Key": "xxx"},
    params=params,
    timeout=30
)

print(response.text)
Example response
51.15.21.75:20300:proxy-user-example:proxy-pass-example
51.15.21.75:20301:proxy-user-example:proxy-pass-example
51.15.21.75:20302:proxy-user-example:proxy-pass-example

SOCKS5 proxy list

GET /api/v1.0/datacenter/proxies

Use protocol=socks5 to select the matching SOCKS5 proxy document.

The authentication and amount filters work the same way for HTTP/S and SOCKS5.

Rate limit10 requests / 60 seconds
ParametersX-API-Key header, authentication=ip_authentication, protocol=socks5, amount=2, output=plain
Endpoint details
ProtocolsAccepted values are http, https, socks5 and both. https selects the HTTP/S document.
Both protocolsprotocol=both can match one HTTP/S and one SOCKS5 document for the selected authentication method.
Per-document amountThe amount limit is applied independently to every matching document.
ExampleWith protocol=both and amount=300, up to 600 entries can be returned for one authentication method.
Request · Python requests
import requests

params = {
    "authentication": "ip_authentication",
    "protocol": "socks5",
    "amount": "2",
    "output": "plain",
}

response = requests.get(
    "https://rotatingproxyhub.com/api/v1.0/datacenter/proxies",
    headers={"X-API-Key": "xxx"},
    params=params,
    timeout=30
)

print(response.text)
Example response
51.15.21.75:20600
51.15.21.75:20601

All available ports

GET /api/v1.0/datacenter/proxies

Use amount=0 to return all available ports from each matching active document.

Every document is capped at 300 returned ports.

Rate limit10 requests / 60 seconds
ParametersX-API-Key header, authentication=ip_authentication, protocol=both, amount=0, output=plain
Endpoint details
Allowed amountUse a whole number from 0 through 300.
Zeroamount=0 means all available ports, capped at 300 per matching document.
One to 300A positive amount returns that many ports starting from the document port_start value.
Invalid valuesNegative values, decimals and values above 300 return HTTP 400.
Request · Python requests
import requests

params = {
    "authentication": "ip_authentication",
    "protocol": "both",
    "amount": "0",
    "output": "plain",
}

response = requests.get(
    "https://rotatingproxyhub.com/api/v1.0/datacenter/proxies",
    headers={"X-API-Key": "xxx"},
    params=params,
    timeout=30
)

print(response.text)
Example response
51.15.21.75:20000
51.15.21.75:20001
...
51.15.21.75:20299
51.15.21.75:20600
...
51.15.21.75:20899
Previous Rotation timeChoose per-request or sticky-session rotation.