Sign up first to get your credentials

Create a free trial account to receive the gateway credentials this quickstart uses.

Sign up

Price monitoring quickstart

Version 1.0

Route your first price-monitoring request through Datorus residential proxies in five steps: sign up, copy your credentials, send a request, handle common errors, and scale up.

  1. Create an account and verify your email
  2. Copy your gateway credentials
  3. Send your first request
  4. Reuse a sticky session
  5. Handle errors and top up as you scale

0 of 5

Before you start

Datorus routes your requests through residential proxies so you can collect public pricing data from destinations you are authorized to access. You need a Datorus account — your gateway credentials are issued automatically when your free trial activates.

StepWhat you do
1Create an account and verify your email
2Copy your gateway credentials from the Dashboard
3Send your first request through the gateway
4Reuse a session for multi-step flows
5Handle common errors and top up as you scale

The example below shows the same first request in cURL, Python, and Node.js. Anonymous visitors see a <your_credentials> placeholder; once you sign in your username is filled in automatically — your password stays masked, so reveal it in the Dashboard when you need it.

Send your first request

curl -x http://<your_credentials>@gw.datorus.io:8001 \
     -L https://target.example.com/products

Sticky sessions

Show example →

Live: send X-Datorus-Session-Id — an opaque id you generate — to pin a multi-step flow to one upstream egress. The gateway honours and echoes it, scoped to your account, with an invalid or missing header falling back to the default per-connection session. The exact TTL, rotation, and concurrency limits are being finalized in Phase 7 load testing; subscribe to the changelog for the published values.

curl -x http://<your_credentials>@gw.datorus.io:8001 \
     -H "X-Datorus-Session-Id: <your-session-id>" \
     -L https://target.example.com/products

Common errors

  • 407
    Proxy Authentication Required

    The gateway rejected your credentials. Copy a fresh username and password from the Dashboard.

    Check credentials
  • 429
    Too Many Requests

    You are sending requests faster than allowed. Back off and retry with a delay.

    Review rate limits
  • 402
    Payment Required

    Your balance is empty. Top up to keep sending requests.

    Top up balance
  • 504
    Gateway Timeout

    The destination took too long to respond. Retry with an exponential backoff.

    Retry guidance
  • 502
    Upstream Failed

    The destination returned an invalid response. Verify the target is reachable.

    Contact support
  • 503
    Service Unavailable

    The gateway is briefly unavailable. Retry after a short pause.

    Check status
More errors → API reference
Residential proxy quickstart — price monitoring