Targeting

You choose where an exit is; Marvel chooses which exit. Targeting is encoded in the proxy password as a small, order-independent grammar:

country-<cc>[-session-<id>][-min_purity-<n>]

Fields are joined by -, order is irrelevant, and each may appear once. country is required; session and min_purity are optional.

Country required

A two-letter ISO 3166-1 alpha-2 code, case-insensitive. It selects which regional Reserve the exit is drawn from.

curl -x resi.marvel.sh:9000 -U "mk_live_…:country-US" https://api.ipify.org   # United States
curl -x resi.marvel.sh:9000 -U "mk_live_…:country-de" https://api.ipify.org   # Germany (lower-case ok)

Check which countries are live right now — and at what grade — with GET /v1/availability. A country with no live capacity returns 503, never a silent fallback to somewhere else.

Country-only, on purpose

There is no ASN or ISP selector, and there never will be. An -asn- or -isp- token is rejected:

targeting is country-only; ASN/ISP selection is not supported

The machine targets ASN so you don’t have to: the Integrity gate re-resolves every exit’s ASN against an independent database and enforces a per-country golden-ASN allowlist. Letting a customer pin an arbitrary ASN is exactly how datacenter and reseller ranges leak into a “residential” pool — so the selector simply isn’t exposed.

Session

A stable handle that pins a sticky exit — the same IP for the life of the session. Allowed characters are letters, digits, and underscore, 1–64 long ([A-Za-z0-9_]{1,64}).

• Omit it → rotating. A fresh exit is drawn for every request. Best for high-volume crawling where each request should look independent.
• Provide it → sticky. Requests carrying the same -session-<id> reuse the same exit, so cookies, carts, and multi-step flows hold together.

# Rotating — new exit each call
curl -x resi.marvel.sh:9000 -U "mk_live_…:country-US" https://api.ipify.org

# Sticky — same exit across calls that share the id
curl -x resi.marvel.sh:9000 -U "mk_live_…:country-US-session-cart_19f3" https://api.ipify.org

See Sessions & the Reserve for lifetime and rotation behaviour.

Min purity

An optional integer 0–100. Rejects any exit whose Purity is below the floor. You rarely need it: the selector already serves the best available grade first (S, then A, then B), so a node is high-quality by default. Use it to tighten — e.g. demand near-pristine exits only.

curl -x resi.marvel.sh:9000 -U "mk_live_…:country-US-min_purity-90" https://api.ipify.org

Combine them

Order doesn’t matter — these are identical:

country-GB-session-run_42-min_purity-95
min_purity-95-session-run_42-country-GB

curl -x resi.marvel.sh:9000 \
  -U "mk_live_…:country-GB-session-run_42-min_purity-95" \
  https://api.ipify.org

Rules at a glance

Field	Required	Format	Default
country	Yes	ISO 3166-1 alpha-2 (case-insensitive)	—
session	No	[A-Za-z0-9_]{1,64}	Rotating (fresh exit per request)
min_purity	No	integer 0–100	Account/selector default

A malformed target is rejected at CONNECT with a 400 and a specific, safe reason — see Errors & status codes.