Proxies.com API

Official documentation for the Proxies.com API (v2)

Introduction

Create, view and modify your Proxies.com proxies via our API. Be sure to set your header "accept" to "application/json".

Create and view your API key at https://www.proxies.com/account/profile

Base URL

https://www.proxies.com/api/v2

Authentication

Bearer YOUR_API_KEY

All API requests must include your API key in the Authorization header.

Example Request

curl -X GET "https://www.proxies.com/api/v2/proxy" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
GET

/proxy

Gets all proxies on the account according to the search parameters

Query Parameters

Parameter Type Description
active boolean If set to 1 it will only retrieve active proxies. If set to 0 it will only retrieve inactive proxies.
type number Set to 4 for IPv4 proxies. Set to 6 for IPv6.
dedicated boolean Set to 1 to search for dedicated proxies. Set to 0 for shared. Omit for both
name string Will match any proxy with this string in the proxy name
ip string Will match any proxy with this string in the proxy IP address
port number Will match any proxy with the provided port
batch string A batch reference ID
limit number Limits the number of returned proxies (default: 1000)
offset integer How many records to offset/skip by. Used for paginating.

Response Example (200 OK)

[
  {
    "reference": "abcdef1234",
    "type": 6,
    "dedicated": false,
    "proxy_address": "beef:beef::beef",
    "connection_address": "1.1.1.1",
    "proxy_port": 12345,
    "username": "someReallyGenericLogin",
    "password": "correctHorseBatteryStaple",
    "auth_ips": [
      "2.2.2.2",
      "3.3.3.3"
    ],
    "created_at": "2021-01-30 23:59:59",
    "expires_at": "2021-02-30 23:59:59",
    "domains": [
      "proxies.com",
      "example.com"
    ],
    "auto_renew": true,
    "cost": 3.5,
    "auto_rotate": true,
    "rotate_time": 120,
    "country": "US",
    "state": "NC"
  }
]
GET

/proxy/{reference}

Gets details about a specific proxy

Path Parameters

Parameter Type Description
reference string The proxy reference ID

Response Example (200 OK)

{
  "reference": "abcdef1234",
  "type": 6,
  "dedicated": false,
  "proxy_address": "beef:beef::beef",
  "connection_address": "1.1.1.1",
  "proxy_port": 12345,
  "username": "someReallyGenericLogin",
  "password": "correctHorseBatteryStaple",
  "auth_ips": [
    "2.2.2.2",
    "3.3.3.3"
  ],
  "created_at": "2021-01-30 23:59:59",
  "expires_at": "2021-02-30 23:59:59",
  "domains": [
    "proxies.com",
    "example.com"
  ],
  "auto_renew": true,
  "cost": 3.5,
  "auto_rotate": true,
  "rotate_time": 120,
  "country": "US",
  "state": "NC"
}
PATCH

/proxy/{reference}/rotate

Rotates the proxy's IP address if it's IPv6

Path Parameters

Parameter Type Description
reference string The proxy reference ID

Response Example (200 OK)

{
  "proxy_address": "beef:beef::abcd"
}
PATCH

/proxy/{reference}/authentication

Updates the authentication requirements for a proxy

Authentication requirements vary based on the proxy type:

  • Non-dedicated IPv4 where you are limited to specific domains requires EITHER Username+password OR IPs.
  • Dedicated IPv4 where you can access any domain requires IPs and Username+password is optional.
  • IPv6 requires IPs and Username+password is optional.

You can replace, append or remove IPs. When the setting "append" is set to true it will add the given IPs to the existing list.
When the setting "remove" is set to true it will remove the given IPs from the existing list.
If both settings are set to false or not provided it will replace the entire list.

Path Parameters

Parameter Type Description
reference string The proxy reference ID

Request Body

{
  "username": "somebadusername",
  "password": "correctHorseBatteryStaple",
  "append": true,
  "remove": false,
  "ips": [
    "1.1.1.1",
    "2.2.2.2"
  ]
}

Response Example (200 OK)

{
  "success": true
}
GET

/account/funds

Gets the available funds for the account

Response Example (200 OK)

{
  "amount": 100
}
PATCH

/proxy/{reference}/name

Updates the name of a proxy

Path Parameters

Parameter Type Description
reference string The proxy reference ID

Request Body

{
  "name": "My New Proxy Name"
}

Response Example (200 OK)

{
  "success": true
}
PATCH

/proxy/{reference}/auto-renew

Updates the auto-renewal setting for a proxy

Path Parameters

Parameter Type Description
reference string The proxy reference ID

Request Body

{
  "auto_renew": true
}

Response Example (200 OK)

{
  "success": true
}

Error Handling

The API uses conventional HTTP response codes to indicate the success or failure of requests:

Code Description
200 - OK Request was successful
400 - Bad Request The request was invalid or cannot be served
401 - Unauthorized Authentication credentials are missing or invalid
403 - Forbidden The request is understood but has been refused or access is not allowed
404 - Not Found The requested resource could not be found
429 - Too Many Requests Rate limit has been exceeded
500 - Server Error An error occurred on the server

Error Response Format

{
  "error": true,
  "message": "A human-readable error message",
  "code": "ERROR_CODE"
}

API Endpoints