API Documentation

Welcome to our API Documentation. You can use as many or as few of the filters below as you wish in a single API call.

Take the API URL below, for example.

It is one of our more popular API URLs, and for good reason as it returns a list of proxies which we have:

We suggest that you read through every API filter below before getting started.

List of API Filters

API Descriptions


verified_within_hours

A filter limiting returned proxies to only the ones we have verified to be active in the previous verified_within_hours hours.

Default: 24

Max: 24

Min: 1

Example URL 1: The URL below would return only proxies verified in the previous 12 hours.

Example URL 2: The URL below would return only proxies verified in the previous hour.


country

A filter limiting returned proxies to only the ones whose 2 letter country code(s) matches country. Separate multiple country codes with a comma.

Default: All countries

Max: 25 country codes. If you need to select more than 25 countries at one time, take a look at the continent option below.

Example URL 1: The URL below would return only proxies whose IP addresses are based in the USA.

Example URL 2: The URL below would return only proxies whose IP addresses are based in the USA (US), South Africa (ZA) and Great Britain(GB). Remember to separate multiple countries with a comma.

See here for a list of country codes: http://verifiedproxies.php/codes.php


continent

A filter limiting returned proxies to only the ones whose 2 letter continent code matches continent. Separate multiple continent codes with a comma.

Default: AF,AN,AS,EU,NA,OC,SA (All continents)

Max: 7 options (there are only 7 continents)

Example URL 1: The URL below would return only proxies whose IP addresses are based in Asia (AS).

Example URL 2: The URL below would return only proxies whose IP addresses are based in both North America (NA) and South America (SA).

Continent codes consist of:

See our stats page for a list of continent codes and their current number of proxies associated with them.


level

Limit returned proxies to only anonymous proxies (A), elite proxies (E), and/or transparent proxies (T)

Default: A,E,T (all proxies)

Accepted values: A, E, T or any combination of those three letters separated by commas.

Example URL 1: The URL below would return only proxies we have verified to be Anonymous AND/OR Elite proxies.

Example URL 2: The URL below would return only proxies we have verified to be Elite proxies.


uptime_greater_than

Limit returned proxies whose uptime has been verified to be greater than a certain percentage. Proxies returned using this filter have been checked at least 10 times. We only include proxies that have been checked 10 or more times to get an accurate value.

Default: 0 (returns all proxies)

Max: 99

Min: 1

Example URL 1: The URL below would return only proxies we have verified to complete 25% or more connection attempts.

Example URL 2: The URL below would return only proxies we have verified to complete 75% or more connection attempts. (NOTE: This is about the highest we recommend setting the uptime percentage, as many public proxies have trouble being up 100% of the time due to their public nature.)


completion_max

Limit returned proxies to those that have been measured to take less than completion_max seconds to complete their connections.

Default: none (returns all proxies)

Max: 60

Min: 1

Example URL 1: The URL below would return only proxies we have verified to complete their connections in 10 seconds or less.

Example URL 2: The URL below would return only proxies we have verified to complete their connections in 30 seconds or less.


connection_max

Limit returned proxies to those that have been measured to take less than connection_max seconds to establish their connections.

Default: none (returns all proxies)

Max: 60

Min: 1

Example URL 1: The URL below would return only proxies we have verified to establish their connections in 20 seconds or less.

Example URL 2: The URL below would return only proxies we have verified to establish their connections in 3 seconds or less.


exclude_ports

Exclude up to 20 different proxy connection ports from your query by separating port numbers with commas.

Default: none (returns all proxies)

Max: 65535

Min: 1

Example URL 1: The URL below would return only proxies without connection ports of 8080.

Example URL 2: The URL below would return only proxies without connection ports of 8080, 3128, and 80.


That's it! If you can think of any other API parameters you think we should add, feel free to contact us anytime.