Retrieve and Filter Live Proxy Lists API

What it does

Free Proxy List returns a live inventory of public proxies, filtered by the criteria you send in the query string. You can request the full matching set in one call, or page through results with limit and offset when you need to cap response size.

Use country, protocol, asn, subnet, port, anonymity, max_latency_ms, min_uptime_pct, recent, and sort to narrow the list to the proxies you care about. The response can come back as txt, json, or csv, depending on the format parameter.

When you ask for format=json, each proxy object can include ip, asn, city, port, region, status, asn_org, country, protocol, anonymity, latency_ms, and uptime_pct. In the default text format, you get proxy addresses in ip:port form. Response headers also report how many rows were returned and how many are available for your filter set.

Free Proxy List is useful when you need a fresh proxy pool for routing tests, scraping workflows, geo-targeted checks, or uptime-based proxy selection. The list updates every few minutes, supports browser-side calls with CORS, and does not require an API key.

GET

The whole live list in one call

https://api.eu.apyhub.com/hproxy/retrieve-filter-live-proxy-lists/api/proxy-list

QUICKSTART

GUIDE

Quickstart

Fetch the live proxy list with no filters to get the full default set.

curl -X GET "https://api.eu.apyhub.com/hproxy/retrieve-filter-live-proxy-lists/api/proxy-list"
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a proxies array, and may also include data when you request format=json. By default, proxies is an array of ip:port strings.

{
  "proxies": [
    "203.0.113.7:1080",
    "45.79.12.44:8080",
    "198.51.100.10:3128"
  ]
}

TRY ITLIVE · 1 ATOM

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Fetches the live proxy inventory and lets you filter the results by fields such as country, protocol, ASN, anonymity, uptime, latency, subnet, and port. The response shape depends on the format query parameter and can return proxy addresses as strings or detailed proxy objects.

Query Parameter(s)

Attribute	Type	Mandatory	Description
asn	Number	No	Filter by Autonomous System Number.
port	String	No	Exact port number.
sort	ENUM	No	Sort order before paging. Allowed values: `reliability`, `latency`. Omit for default ordering (alive first, then fastest).
limit	String	No	Max rows in this response. Omit to get the entire matching set in one call. Ceiling: 10,000.
format	ENUM	No	Response format. Allowed values: `txt`, `json`, `csv`. Default: `txt`.
offset	String	No	Skip this many rows. Used with `limit` for pagination.
recent	String	No	Include proxies that worked in the last 48 hours but are quiet now (`status=recently_alive`). Greatly increases result size.
subnet	String	No	Filter by `/24` subnet, such as `45.61.188` for `45.61.188.0/24`.
country	String	No	2-letter country code, such as `US`, `GB`, or `DE`.
protocol	String	No	Comma-separated protocol filter, such as `http,https`. Matches proxies supporting any listed protocol.
anonymity	ENUM	No	Anonymity grade required. Allowed values: `elite`, `anonymous`, `transparent`. Proxies without a grade are excluded.
max_latency_ms	String	No	Maximum acceptable latency in milliseconds.
min_uptime_pct	String	No	Minimum uptime percentage required, from 0 to 100.

Response

Returns a JSON object with a data array field.

Parameter	Type	Description
data	Object Array	Detailed proxy objects returned when `format=json`. Each object can include `ip`, `asn`, `city`, `port`, `region`, `status`, `asn_org`, `country`, `protocol`, `anonymity`, `latency_ms`, and `uptime_pct`.
proxies	String Array	Proxy addresses matching the filters in `ip:port` format. Returned for the default text response format.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLCheck Proxy Connectivity and Anonymity APIHProxy CALLRetrieve IP Address Location and Network Details APIHProxy CALLRetrieve Live Web Data APISpecStream CALLIP ASN Lookup APIDosvak LLC

From the blog

Reads that touch this API.

Full Site Audit API – Page-Level SEO, Security, and Mobile Checks in One CallJul 9, 2026 curl HEAD Request: Check Headers Without DownloadingSep 29, 2026 Link Preview API: Safe Link Previews Without Building a ScraperAug 5, 2026 REST API Rate Limits Explained: How to Manage Free API QuotasJul 9, 2026