Developer resources

Documentation.

Location Targeting

Target by country, state, city, or ASN using ProxyRise username modifiers. All targeting is controlled by the username — no separate API call is needed.

How Location Targeting Works

Your generated proxy returns a username like res-us and a password (your BluesMinds auth). Append ProxyRise modifiers directly to that username to scope your exit location.

res_sc-us_california_losangeles:YOUR_PASSWORD@172.65.145.196:3389

The suffix -us_california_losangeles on a res_sc username tells the upstream to route through a rotating residential IP in Los Angeles, California, USA.

Username Formats
LevelSyntaxExampleDescription
Basic (any country){type}-{country}res-us, stc-nl, mob-uk, dc-deRoutes through an IP in the specified country. Use the ISO 3166-1 alpha-2 code (or ANY for random).
State / City (res_sc, stc_sc){type}_sc-{country}_{city}
{type}_sc-{country}_{state}_{city}
res_sc-us_california_losangelesTargets a specific state and city. Names are lowercase with underscores. 38 supported countries (highest precision in the US).
Sticky session (SID){type}-{country}-sid-{N}res-us-sid-checkout01Same IP across requests while traffic flows. Session IDs accept up to 11 letters or numbers.
Timed sticky (Lsid){type}-{country}-Lsid-{id}-TTL-{seconds}res-us-Lsid-875078898-TTL-3600Timed sticky route from 60 to 40010 seconds (up to 180 minutes).
Residential long session (PR-LLS)resfix-{country}-nnid-{token}resfix-us-nnid-0Start with nnid-0 over HTTP, capture X-PR-LLS, then reuse the returned token for about one hour.
ASN targeting{type}-{country}-asn-{number}res-us-asn-14615Pins the exit IP to a specific ISP/network by ASN. Cannot be combined with SID.
Proxy Type Codes
CodeLabelNote
resResidential (Rotating)Rotates IP every request
res_scResidential (State/City)Geo-targeted rotating residential
resfixResidential (Long Session)X-PR-LLS token flow, up to about 1 hour
stcStatic ISPISP-grade IPs that don't rotate
stc_scStatic ISP (State/City)Geo-targeted static ISP
mobMobileReal mobile carrier IPs
dcDatacenterFast DC IPs, 23 countries
Sticky Sessions

Keep the same IP across multiple requests by appending -sid-{ID}. IDs accept 1–11 letters or numbers. Reuse the same ID for every request in one browsing context; long idle gaps can release the route.

# Without sticky session (new IP each request)
curl -x "http://res-us:YOUR_PASSWORD@172.65.145.196:3389" https://httpbin.org/ip
# → IP: 203.0.113.1

curl -x "http://res-us:YOUR_PASSWORD@172.65.145.196:3389" https://httpbin.org/ip
# → IP: 203.0.113.99 (different!)

# With sticky session (same IP across requests)
curl -x "http://res-us-sid-123456789:YOUR_PASSWORD@172.65.145.196:3389" https://httpbin.org/ip
# → IP: 198.51.100.42

curl -x "http://res-us-sid-123456789:YOUR_PASSWORD@172.65.145.196:3389" https://httpbin.org/ip
# → IP: 198.51.100.42 (same!)
ASN Targeting

Pin to a specific ISP or network by ASN (Autonomous System Number). ASN targeting is country-scoped and cannot be combined with sticky session IDs.

# Route through a specific network in the US
curl -x "http://res-us-asn-14615:YOUR_PASSWORD@172.65.145.196:3389" https://httpbin.org/ip

# Mobile IP on a specific carrier
curl -x "http://mob-gb-asn-12345:YOUR_PASSWORD@172.65.145.196:3389" https://httpbin.org/ip

The public /asn/countries and /asn/list?country=… endpoints expose the full ASN catalog.

Common Country Codes
USUnited States
GBUnited Kingdom
DEGermany
FRFrance
JPJapan
INIndia
BRBrazil
CACanada
AUAustralia
NLNetherlands
SGSingapore
KRSouth Korea
ITItaly
ESSpain
PLPoland
SESweden

203 countries are supported. The full list is available from the public /countries endpoint.