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
- 1Open a terminal with cURL installed (preinstalled on macOS/Linux).
- 2Use -x with your Aethyn credentials and endpoint.
- 3Hit an IP echo endpoint to confirm the exit IP.
- 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/ipTarget a specific country
# Route through a German residential IP
curl -x "http://aethyn-XXXXX-country-de:PASSWORD@proxy.aethyn.io:2099" \
https://httpbin.org/ipSOCKS5 instead of HTTP
curl --socks5 "proxy.aethyn.io:1099" \
--proxy-user "aethyn-XXXXX:PASSWORD" \
https://httpbin.org/ipReplace 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.
Docs, solutions & blog
Related solution guideEnd-to-end workflow that pairs with this integration.Premium residential proxiesCost-efficient rotating residential pool from €2.00/GB for bulk scraping and monitoring.Elite residential proxiesCurated high-trust pool with city and ISP targeting for hard anti-bot targets.Quickstart docsCredentials, endpoints, and your first proxied request.Proxy glossaryPlain-English definitions for residential proxies, rotation, anti-bot, and scraping terms.