Skip to content
TPPTPP Docs

Targeting

Targeting options are appended to your proxy username as -key-value pairs:

USER-cc-de-city-berlin-asn-3320
Key Value Example
cc ISO 3166-1 alpha-2 country code, case-insensitive USER-cc-de
city City name, lowercase, spaces as underscores USER-cc-us-city-new_york
asn Autonomous system number, with or without AS prefix USER-asn-3320

Options combine freely and each may appear once. With no options, every connection gets a random exit from the whole pool.

Rules

Section titled “Rules”
  • Invalid options fail authentication. An unknown key, a repeated key, or a malformed value (country-de, cc-deu, asn-abc) is rejected with an auth error rather than silently ignored - otherwise you’d be billed for untargeted traffic you didn’t ask for.
  • No matching exit fails the connection, not authentication: you’ll get HTTP 502 (or SOCKS reply 0x04). Pool composition shifts continuously; narrow targets - a small city, a specific ASN - may briefly have no live exits. Loosen the target or retry.
  • City names must match our records: lowercase with underscores (new_york, sao_paulo). Pairing city with cc is recommended to disambiguate.

Examples

Section titled “Examples”
Terminal window
# Any German exit
curl -x http://USER-cc-de:PASS@eu.tpp.io:1080 https://api.ipify.org


# Deutsche Telekom (AS3320) exits only
curl -x http://USER-asn-3320:PASS@eu.tpp.io:1080 https://api.ipify.org


# New York City
curl -x http://USER-cc-us-city-new_york:PASS@us.tpp.io:1080 https://api.ipify.org