Litport Free Proxy SDK for Elixir

Elixir client for Litport's public snapshot of verified HTTP, SOCKS4, and SOCKS5 proxies. It uses only Erlang's built-in :httpc for HTTP and requires no API key.

Install

def deps do
  [
    {:litportnet_free_proxy, "~> 0.1"}
  ]
end

Usage

{:ok, client} = Litportnet.FreeProxy.new()

{:ok, proxies} =
  Litportnet.FreeProxy.get_proxies(client,
    protocol: "socks5",
    country: "us",
    max_latency_ms: 500,
    min_uptime_7d: 90,
    min_checks_7d: 50,
    checked_within_min: 30
  )

Enum.each(proxies, &IO.puts(&1.url))

{:ok, best} = Litportnet.FreeProxy.pick_best(client, 5, protocol: "http")

get_proxies/2 and pick_best/3 return normalized Litportnet.FreeProxy.Proxy structs. Filters accept protocol, country, anonymity, HTTPS, maximum latency, minimum seven-day uptime, minimum checks, freshness (1-1,440 minutes), and limit. Results sort by seven-day uptime, latency, then URL. uptime_7d is nil when a record has fewer than 50 checks.

The API envelope validates count, truncated, a two-minute generatedAt window, public IPv4 addresses, and nullable fields. Set timeout: on new/1; provide transport: fn url, timeout -> {:ok, status, headers, body} end for deterministic tests.

Test

mix test

Resources

• Free proxy list
• API documentation
• SDK source

Free proxies are for testing only. Never route credentials, cookies, payment data, or private data through them.