Targeting · glossary

Username parameters

Username parameters are key-value pairs appended to the username of a proxy credential (for example USER-cc-de-city-berlin-sid-a1b2) that tell the gateway which exit to choose and how long to keep it. They let a single hostname and credential serve every country, city, provider and session mode without generating new proxy lists, because the choice travels with each connection.

1 min read Also called proxy username syntax, inline parameters Updated

Anatomy#

ParameterValuesMeaning
-cc-<code>ISO 3166-1 alpha-2Country of the exit
-state-<code>US postal codeUS state (with -cc-us)
-city-<name>lowercase ASCII, no spacesCity inside the country
-asn-<number>AS numberProvider or mobile carrier
-sid-<id>a-z 0-9, up to 32Session identifier for a sticky session
-ttl-<duration>1m to 24hLifetime of the sticky session

Rules#

  • Order does not matter; unknown keys are rejected with a 400 so typos never silently route elsewhere.
  • The password never changes with parameters.
  • With IP whitelisting, send any username to carry parameters; the password is ignored.
  • URL-encode nothing: the allowed characters are all safe in a proxy URL.

How it works at ProxShift#

ProxShift uses exactly six parameters (-cc-, -state-, -city-, -asn-, -sid-, -ttl-) on res.proxshift.com and the applicable subset on mob.proxshift.com; the documentation page lists every value and error.

Ready when you are

See it on a real request.

Create an account, top up $20 and run the quickstart against your own target. Traffic you buy never expires.