Skip to main content
GET
/
v4
/
account
/
{subAccountId}
/
datacenter_shared
/
proxy-list
Get datacenter proxy list
curl --request GET \
  --url https://api.proxyscrape.com/v4/account/{subAccountId}/datacenter_shared/proxy-list \
  --header 'api-token: <api-key>'
"<string>"

Authorizations

​
api-token
string
header
required

API key. Create and manage keys at /v4/account/api-keys or in the dashboard.

Path Parameters

​
subAccountId
string<uuid>
required

Query Parameters

​
type
enum<string>

Controls download behaviour. getproxies (default) sends a Content-Disposition: attachment header so the browser treats the response as a file download, and stamps last_downloaded on the account. displayproxies returns the same list inline with no download header and no timestamp update.

Available options:
getproxies,
displayproxies
​
country[]
string[]

Filter proxies by ISO 3166-1 alpha-2 country code (e.g. us, de). Pass multiple values to include proxies from any of those countries. Pass all (or include all in the array) to skip country filtering and return proxies from all countries.

​
protocol
enum<string>
required
Available options:
http,
socks
​
format
enum<string>

Output format. Omit for default plain text (one host:port per line). json returns a structured object with a data array, totals, and draw counter. data returns a country breakdown with counts but no proxy IPs. credentials returns credential-formatted lines using the account's proxy username and password — requires proxy_credentials_enabled on the account, returns 403 if not enabled.

Available options:
json,
data,
credentials
​
proxy_format
enum<string>
default:ipport

Controls how the proxy address is formatted in the output. ipport (default) returns bare host:port. protocolipport prepends the scheme: http://host:port or socks5://host:port. Has no effect when format=credentials — that mode always strips any prefix and derives the scheme from the protocol parameter.

Available options:
ipport,
protocolipport
​
credential_format
enum<integer>
default:2

Line format for credential-based output. Only applies when format=credentials; silently ignored for all other format values. 1 → host:port:username:password. 2 (default) → username:password@host:port. 3 → http://username:password@host:port or socks5://username:password@host:port (scheme derived from the protocol parameter).

Available options:
1,
2,
3
​
status
enum<string>

Filter proxies by availability. online returns only currently reachable proxies. offline returns only unreachable proxies. Omit to return all proxies regardless of status.

Available options:
online,
offline
​
start
integer
default:0

Zero-based offset into the filtered result set. Default is 0.

Required range: x >= 0
​
limit
integer

Maximum number of proxies to return. Can also be passed as length (alias). Applied after all other filters.

Required range: x >= 1
​
length
integer

Alias for limit.

Required range: x >= 1
​
draw
integer
default:0

Arbitrary integer echoed back unchanged in the draw field of format=json responses. Used by DataTables to correlate requests with responses. Has no effect on other format values.

Response

Success. Response content-type and shape depend on the format parameter.

One proxy address per line. Format of each line is controlled by proxy_format: ipport (default) → host:port; protocolipport → http://host:port or socks5://host:port.