SH
Languages & HTTP Clients

cURL proxy integration

cURL is the fastest way to verify your proxy works. The -x (or --proxy) flag accepts a full username:password@host:port string, so you can confirm your exit IP and targeting in one line before wiring proxies into code.

Setup steps

  1. 1Open a terminal with cURL installed (preinstalled on macOS/Linux).
  2. 2Use -x with your Aethyn credentials and endpoint.
  3. 3Hit an IP echo endpoint to confirm the exit IP.
  4. 4Swap the username suffix to test country or city targeting.

Code

Check your exit IP
curl -x "http://aethyn-XXXXX:PASSWORD@proxy.aethyn.io:2099" \
     https://httpbin.org/ip
Target a specific country
# Route through a German residential IP
curl -x "http://aethyn-XXXXX-country-de:PASSWORD@proxy.aethyn.io:2099" \
     https://httpbin.org/ip
SOCKS5 instead of HTTP
curl --socks5 "proxy.aethyn.io:1099" \
     --proxy-user "aethyn-XXXXX:PASSWORD" \
     https://httpbin.org/ip

Replace aethyn-XXXXX and PASSWORD with your dashboard credentials. See the full targeting reference and protocol/port list.

Tips

  • Run the same command twice — the exit IP should change when rotating.
  • Add -v to inspect the CONNECT tunnel if a request fails.
  • Use --socks5-hostname to resolve DNS through the proxy on SOCKS5.

cURL proxy FAQ

How do I verify targeting works?
Hit https://httpbin.org/ip (or any geo-IP service) with a -country-XX suffix and confirm the returned IP geolocates to that country.

Ready to wire up cURL?

Get your credentials and route your first cURL request through residential IPs in minutes.

Docs, solutions & blog

Related integrations

All integrations