# HProxy Free Proxy List (`hproxy-owner/hproxy-free-proxy-list`) Actor The biggest free proxy list on Earth, verified around the clock. 780,000+ proxies collected worldwide and thousands live right now: HTTP, HTTPS, SOCKS4 and SOCKS5, refreshed every ~2 minutes. Free, no API key, no signup. Powered by HProxy. - **URL**: https://apify.com/hproxy-owner/hproxy-free-proxy-list.md - **Developed by:** [HProxy](https://apify.com/hproxy-owner) (community) - **Categories:** Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## HProxy Free Proxy List The biggest free proxy list on the internet, live and continuously verified. HProxy collects 780,000+ proxies from across the web and re-checks them around the clock, so this actor hands you thousands of working HTTP, HTTPS, SOCKS4 and SOCKS5 proxies, refreshed roughly every 2 minutes. Free. No API key. No signup. Powered by [HProxy](https://hproxy.com). The same list is also on GitHub, updated every couple of minutes: **[github.com/hproxy-com/free-proxy-list](https://github.com/hproxy-com/free-proxy-list)**. ### Two ways to use it - **Full details** (default): every proxy with country, city, ISP/ASN, anonymity, latency, uptime (live, 24h, 7d) and a reliability rating. - **Raw ip:port**: just the addresses, ready to paste into your tool. ### What you get - Thousands of live, working proxies at any moment, pulled from a pool of 780,000+ - HTTP, HTTPS, SOCKS4 and SOCKS5 - Checked continuously for speed and uptime - Filter by country, protocol, anonymity and count ### Input options | Option | What it does | | --- | --- | | Output format | `Full details` or `Raw ip:port only` | | Max proxies | 1 to 10000 | | Protocol | All, or HTTP / HTTPS / SOCKS4 / SOCKS5 | | Country | Two-letter code like `US`, `DE`, `GB`, or All | | Anonymity | All, Elite, Anonymous, or Transparent | | Include recently-alive (48h) | Adds proxies seen alive in the last 48 hours | ### Example output (full) ```json { "proxy": "173.212.203.209:80", "ip": "173.212.203.209", "port": 80, "protocols": ["http"], "country_code": "FR", "city": "Lauterbourg", "asn_org": "Contabo GmbH", "latency_ms": 51, "uptime_pct": 100, "reliability": "stable" } ```` ### Good to know Free proxies are shared and unstable by nature, so expect some to be slow or already offline at any moment. That is the trade for free. If you need proxies that just work, HProxy also sells residential, mobile, ISP and datacenter proxies plus a scraper API at [hproxy.com](https://hproxy.com). - Full list as downloadable files: **[github.com/hproxy-com/free-proxy-list](https://github.com/hproxy-com/free-proxy-list)** - Direct API: `https://hproxy.com/api/proxy-list` # Actor input Schema ## `outputFormat` (type: `string`): Full = every proxy with country, ISP/ASN, anonymity, latency, uptime and reliability. Raw = just ip:port lines. ## `limit` (type: `integer`): How many proxies to return (1 to 10000). ## `protocol` (type: `string`): Filter by a single protocol, or All. ## `country` (type: `string`): Two-letter country code, e.g. US, DE, GB. Leave empty for all countries. ## `anonymity` (type: `string`): Filter by anonymity, or All. ## `recentOnly` (type: `boolean`): Include proxies seen alive within the last 48 hours. Bigger list, slightly less fresh. ## Actor input object example ```json { "outputFormat": "full", "limit": 1000, "protocol": "", "country": "", "anonymity": "", "recentOnly": false } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("hproxy-owner/hproxy-free-proxy-list").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("hproxy-owner/hproxy-free-proxy-list").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call hproxy-owner/hproxy-free-proxy-list --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=hproxy-owner/hproxy-free-proxy-list", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "HProxy Free Proxy List", "description": "The biggest free proxy list on Earth, verified around the clock. 780,000+ proxies collected worldwide and thousands live right now: HTTP, HTTPS, SOCKS4 and SOCKS5, refreshed every ~2 minutes. Free, no API key, no signup. Powered by HProxy.", "version": "0.1", "x-build-id": "7M8QqbBFZc7VT3I9R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hproxy-owner~hproxy-free-proxy-list/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hproxy-owner-hproxy-free-proxy-list", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/hproxy-owner~hproxy-free-proxy-list/runs": { "post": { "operationId": "runs-sync-hproxy-owner-hproxy-free-proxy-list", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/hproxy-owner~hproxy-free-proxy-list/run-sync": { "post": { "operationId": "run-sync-hproxy-owner-hproxy-free-proxy-list", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "outputFormat": { "title": "Output format", "enum": [ "full", "ip_port" ], "type": "string", "description": "Full = every proxy with country, ISP/ASN, anonymity, latency, uptime and reliability. Raw = just ip:port lines.", "default": "full" }, "limit": { "title": "Max proxies", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many proxies to return (1 to 10000).", "default": 1000 }, "protocol": { "title": "Protocol", "enum": [ "", "http", "https", "socks4", "socks5" ], "type": "string", "description": "Filter by a single protocol, or All.", "default": "" }, "country": { "title": "Country (ISO code)", "type": "string", "description": "Two-letter country code, e.g. US, DE, GB. Leave empty for all countries.", "default": "" }, "anonymity": { "title": "Anonymity level", "enum": [ "", "elite", "anonymous", "transparent" ], "type": "string", "description": "Filter by anonymity, or All.", "default": "" }, "recentOnly": { "title": "Include recently-alive (last 48h)", "type": "boolean", "description": "Include proxies seen alive within the last 48 hours. Bigger list, slightly less fresh.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```