Docs

Run your first request in 5 minutes.

Endpoint format, credentials, rotation, and country targeting — everything between checkout and your first 200.

The endpoint

residential.basilproxies.com

host

1000

port

http 1000 · https 1001 · socks5 1002

USER

username

PASS_country-DE_session-9f2k41ab_lifetime-60

password + flags

Flags ride the password, separated by underscores, always in this order: country → city → session. The username never carries flags.

Credentials

Checkout creates your proxy user and password. The pair lives on the Residential page of the dashboard, right above the generator — every flag in this guide rides on top of that password.

Open the dashboard

Rotating vs sticky

  • no flag

    Rotating — every request exits from a new IP. This is the default; nothing to configure.

  • _session-k4mz61pq_lifetime-60

    Sticky — invent any 8-character id and the same id keeps the same IP. Lifetime is in minutes, up to 120.

  • _session-k4mz61pq_lifetime-hard

    Sticky, whole life — holds one IP for as long as it stays online. No timer.

Country targeting

  • _country-US

    Two-letter ISO code, uppercase. Leave the flag off entirely for the worldwide pool.

  • _country-US_city-new.york

    City targeting — lowercase, spaces become dots. Works alongside any session flags; country comes first.

Make a request

The same request in three stacks. Swap USER:PASS for your pair and run it.

request.sh
# New IP on every request — flags ride the password
curl -x "http://USER:[email protected]:1000" \
  https://ipinfo.io/json

When it doesn't work

  • 407 Proxy Authentication Required

    Wrong user:pass. Copy the pair from the dashboard again — flags belong on the password, never the username.

  • Everything times out

    Wrong port for the protocol: http 1000, https 1001, socks5 1002.

  • Connects, but the target blocks you

    That pool is burned for that target. Rotate the session, switch countries, or switch products.