Free Proxy Information API
Free Proxy Info
Returns metadata about the currently stored free proxy list.
Authentication uses the apiKey query parameter only. JWT cookies and X-API-Key headers are not accepted.
The API key must belong to an ACTIVE ProxyTitan user account.
Rate
10 requests per 60 seconds
Note
last_checked is returned exactly as stored in the free proxy JSON file.
You can also view or download the latest free proxies at proxytitan.com/free-proxy-list .
You can also view or download the latest free proxies at proxytitan.com/free-proxy-list .
Required query parameters
apiKey
Endpoint details
Response fields
success - boolean data.last_checked - string data.country_amount - integer data.proxy_amount - integer
Possible error responses
400 - apiKey is missing 401 - API key is invalid or the account is not ACTIVE 404 - free proxy list file was not found 429 - request rate limit exceeded 500 - proxy list file or server processing error
Python • requests • query parameter
import json
import requests
def get_free_proxy_info(api_key: str) -> dict:
url = "https://proxytitan.com/api/v1.0/free/proxies/info"
params = {"apiKey": api_key}
response = requests.get(url, params=params, timeout=30)
print("HTTP status:", response.status_code)
data = response.json()
print(json.dumps(data, indent=2))
response.raise_for_status()
return data
get_free_proxy_info("xxx") Replace xxx with the API key stored at users.auth.api_key.
Response • 200 OK • application/json
Show example response
Click to reveal the exact successful JSON structure.
The copied response is valid JSON without an added status label.
Available Countries
Returns every valid ISO-2 country represented by at least one proxy in the current free proxy list.
Authentication uses the apiKey query parameter only. JWT cookies and X-API-Key headers are not accepted.
Country entries are sorted alphabetically by country name, and each code is returned in lowercase.
Rate
10 requests per 60 seconds
Note
Use countries[].code for the countries filter on the free proxy list endpoint and for country flags in your UI.
Required query parameters
apiKey
Endpoint details
Response fields
success - boolean country_amount - integer countries - array countries[].country - string countries[].code - lowercase ISO-2 string
Possible error responses
400 - apiKey is missing 401 - API key is invalid or the account is not ACTIVE 404 - free proxy list file was not found 429 - request rate limit exceeded 500 - proxy list file or server processing error
Python • requests • query parameter
import json
import requests
def get_free_proxy_countries(api_key: str) -> dict:
url = "https://proxytitan.com/api/v1.0/free/proxies/info/countries"
params = {"apiKey": api_key}
response = requests.get(url, params=params, timeout=30)
print("HTTP status:", response.status_code)
data = response.json()
print(json.dumps(data, indent=2))
response.raise_for_status()
return data
get_free_proxy_countries("xxx") Replace xxx with the API key stored at users.auth.api_key.
Response • 200 OK • application/json
Show example response
Click to reveal the exact successful JSON structure.
The copied response is valid JSON without an added status label.