Why is the response not JSON?

Most proxy consumers want a flat ip:port list. Returning raw lines avoids JSON parsing and keeps the response small enough to pipe directly into curl, requests, or wget.

Is there authentication?

No. The endpoint is public and read-only. Apply your own caching layer if you call it frequently.

What is the response size limit?

Up to 10,000 of the most recent proxies are returned per request, ordered by checked_at descending.

Are there rate limits?

There is no enforced per-IP limit at this time. Please cache responses for at least 30 seconds and avoid burst loops.

How should I handle failed proxies?

Treat each entry as a hint. Always verify reachability from your own client and rotate the proxy on the first connection error.

API specification

Raw proxy filtering API

Proxcy exposes a single read-only endpoint that returns live, filtered proxies as plain text. Compose filters with query parameters; the response is a newline-delimited stream of ip:port (or protocol://ip:port) entries.

Endpoint

GEThttps://proxcy.riyo.me/api/raw

Content-Type: text/plain. No authentication required.

Query parameters

Name	Type	Required	Notes	Example
protocol	string	no	Comma-separated. Allowed values: http, https, socks4, socks5. Case-insensitive.	protocol=socks5,socks4
country	string	no	Comma-separated ISO-3166 alpha-2 codes (e.g. us, jp, de). Case-insensitive.	country=us,jp
google	boolean	no	true to return only proxies that successfully reached https://www.google.com/generate_204. false for proxies that failed the Google check.	google=true
anonymity	string	no	Comma-separated. Allowed values: elite, anonymous, transparent. Filters by anonymity level detected via httpbin.org/headers inspection. elite = high anonymity (no revealing headers), anonymous = proxy detected but real IP hidden, transparent = real IP exposed.	anonymity=elite,anonymous
format	string	no	Output shape. ip_port (default) emits ip:port. protocol_ip_port emits protocol://ip:port.	format=protocol_ip_port

Examples

All SOCKS5 proxies that can reach Google

curl "https://proxcy.riyo.me/api/raw?protocol=socks5&google=true"

US or Japan proxies in protocol://ip:port form

curl "https://proxcy.riyo.me/api/raw?country=us,jp&format=protocol_ip_port"

High anonymity (elite) SOCKS5 proxies

curl "https://proxcy.riyo.me/api/raw?protocol=socks5&anonymity=elite&google=true"

Sample response (text/plain)

192.0.2.1:1080
198.51.100.42:8080
203.0.113.99:443

Errors

500 Database configuration missing — server is misconfigured. Try again later.
500 Failed to fetch proxies — upstream database error. Retry with exponential backoff.

Rate limits

There is no hard rate limit today. Please cache responses for at least 30 seconds and back off on errors. Excessive abuse may be filtered at the edge.

API FAQ

Why is the response not JSON?
Most proxy consumers want a flat ip:port list. Returning raw lines avoids JSON parsing and keeps the response small enough to pipe directly into curl, requests, or wget.
Is there authentication?
No. The endpoint is public and read-only. Apply your own caching layer if you call it frequently.
What is the response size limit?
Up to 10,000 of the most recent proxies are returned per request, ordered by checked_at descending.
Are there rate limits?
There is no enforced per-IP limit at this time. Please cache responses for at least 30 seconds and avoid burst loops.
How should I handle failed proxies?
Treat each entry as a hint. Always verify reachability from your own client and rotate the proxy on the first connection error.