Skip to content
IPRelay

Documentation

Service addresses below are illustrative. Replace YOUR_USERNAME and YOUR_PASSWORD with credentials from your dashboard.

Quickstart

Add balance, copy your gateway credentials, then send a request through the gateway.

cURL
curl -x http://gw.iprelay.sbs:8000 \
  -U "YOUR_USERNAME-res-country-de:YOUR_PASSWORD" \
  https://example.com/

Authentication

Authenticate with a username and password, or with an IP allowlist. Options such as product, country and session are appended to the username, separated by hyphens.

username format
YOUR_USERNAME-{res|dc}-country-{cc}[-region-{r}][-city-{c}][-session-{id}][-ttl-{n}m]

Gateway endpoints

  • Gateway host: gw.iprelay.sbs
  • HTTP/HTTPS port: 8000
  • SOCKS5 port: 1080
  • API base URL: https://api.iprelay.sbs/v1

Rotating sessions

Omit the session parameter and each request is routed independently. Rotation is included in the price.

Sticky sessions

Add session-<id> to keep the same route across requests. Use ttl-<minutes>m to control the window. Any alphanumeric ID you generate works.

Session generator

Simulated
curl
curl -x http://gw.iprelay.sbs:8000 \
  -U "YOUR_USERNAME-res-country-us-session-k3m9x2qa-ttl-10m:YOUR_PASSWORD" \
  https://example.com/
  1. Press “Send request” to simulate requests.

With a sticky session ID, every request reuses the same route until the session expires or you change the ID. Rotating mode picks a new route per request.

Location targeting

Use ISO 3166-1 alpha-2 country codes in lowercase, e.g. country-gb. Region and city targeting are available on residential where supported. Available locations are shown during configuration.

HTTP and SOCKS5 configuration

SOCKS5 · cURL
curl --socks5-hostname gw.iprelay.sbs:1080 \
  -U "YOUR_USERNAME-dc-country-us:YOUR_PASSWORD" \
  https://example.com/

IP allowlists

Add your server's public IPs in the dashboard to connect without a password. Allowlisted connections still accept options via the username field.

API · add allowlist entry
curl -X POST https://api.iprelay.sbs/v1/allowlist \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ip": "192.0.2.10", "label": "scraper-01"}'

Errors and retries

  • 407 — authentication failed. Check credentials or allowlist.
  • 402 — balance exhausted. Top up to resume.
  • 429 — concurrency limit reached. Back off and retry.
  • 502 / 504 — upstream route failed or timed out. Retry with exponential backoff; sticky sessions may need a new ID.

Usage and billing API

cURL
curl https://api.iprelay.sbs/v1/usage?from=2026-10-01&to=2026-10-31 \
  -H "Authorization: Bearer YOUR_API_KEY"

Acceptable-use requirements

Use IPRelay only for lawful purposes and in line with the Acceptable Use Policy. Credential abuse, fraud, malware, spam, unlawful access and evasion of security controls are prohibited and lead to suspension.