Skip to content
1 GB of residential proxies, free. $0 today, card required.

Everything is a standard proxy.
The rest is an API.

Point any HTTP or SOCKS5 client at gw.databay.co:8888 and name the network, country and session in the username. Sub-users, quotas, usage and allowlists each have a REST route. There is no SDK to install.

1 GB free for 7 days. Card required. From day 7, automatic top-ups of 25 GB for $13.75 unless you turn them off.

Proxy traffic

  1. Your client
  2. HTTP · HTTPS CONNECT · SOCKS5
  3. gw.databay.co:8888Reads the route from the username
  4. zone · country · session
  5. ExitOn the network and in the country you named

Account API

  1. Your backendAuthorization: Bearer
  2. JSON over HTTPS
  3. Account API v1Every dashboard action for sub-users
  4. REST routes
  5. Your accountProxy users · bandwidth · usage · allowlists
The two halves of an integration. Traffic goes through one gateway; the account API manages the proxy users and allowlists that may sign in to it.

Quickstart

Your first request in three steps.

  1. Get your proxy credentials.

    Start the free trial or place an order. The dashboard shows your proxy username and password as soon as it is active.

  2. Name the route in the username.

    The word after zone- picks the network and countryCode- the country. Add sessionId- to keep one exit across connections.

  3. Run one request and read the exit.

    Each snippet calls databay.com/what-is-my-ip/json through the gateway, so the response is the IP address and country your target will see. The password stays in DATABAY_PROXY_PASS; no snippet writes it down.

Choose a client

Highlighted: values you supply

exit-check.shcURL
: "${DATABAY_PROXY_PASS:?Load DATABAY_PROXY_PASS from your secret store}"
# cURL URL-decodes --proxy-user once; %25 preserves literal % in routing values.
DATABAY_PROXY_USER='USERNAME-zone-residential'

curl --disable --silent --show-error --fail-with-body \
  --proxy 'http://gw.databay.co:8888' \
  --proxy-basic \
  --proxy-user "${DATABAY_PROXY_USER}:${DATABAY_PROXY_PASS}" \
  --connect-timeout 10 \
  --max-time 30 \
  'https://databay.com/what-is-my-ip/json'

Prints the exit IP address and its location as JSON.

Tested against a cURL 8.21.0 local mock trace.

Full cURL guide

cURL receives proxy credentials through --proxy-user and URL-decodes them once. An HTTPS destination uses CONNECT through this HTTP proxy; it does not require an https:// proxy URL.

exit_check.pyPython Requests
import os
import sys
from urllib.parse import quote
import requests

username = quote("USERNAME-zone-residential", safe="")
password = quote(os.environ["DATABAY_PROXY_PASS"], safe="")
proxy_url = f"http://{username}:{password}@gw.databay.co:8888"
proxies = {"http": proxy_url, "https": proxy_url}

try:
    response = requests.get(
        "https://databay.com/what-is-my-ip/json",
        proxies=proxies,
        timeout=(10, 20),
    )
    response.raise_for_status()
    print(response.json())
except requests.exceptions.Timeout:
    print("Proxy check timed out within the configured request budget.", file=sys.stderr)
    raise SystemExit(1)
except requests.exceptions.RequestException:
    print("Proxy check failed; verify credentials, route availability, and destination permission.", file=sys.stderr)
    raise SystemExit(1)

Prints the exit IP address and its location as JSON.

Tested against a Requests 2.34.2 pinned local mock fixture.

Full Python guide

Requests proxy authentication lives in a percent-encoded proxy URL assembled at runtime. The mapping keys select destination schemes. Both can use the same HTTP proxy URL; the read timeout is an inactivity limit, not a total download deadline.

exit-check.mjsNode.js / Undici
import { fetch, ProxyAgent } from 'undici';

const password = process.env.DATABAY_PROXY_PASS;
if (!password) throw new Error('DATABAY_PROXY_PASS is required');

const username = 'USERNAME-zone-residential';
const dispatcher = new ProxyAgent({
  uri: 'http://gw.databay.co:8888',
  token: `Basic ${Buffer.from(`${username}:${password}`).toString('base64')}`,
});

try {
  const response = await fetch('https://databay.com/what-is-my-ip/json', {
    dispatcher,
    signal: AbortSignal.timeout(30_000),
  });
  if (!response.ok) throw new Error(`Unexpected HTTP status ${response.status}`);
  console.log(await response.json());
} catch (error) {
  const message = error instanceof Error && error.name === 'TimeoutError'
    ? 'Proxy check exceeded the 30 second deadline.'
    : 'Proxy check failed; verify credentials, route availability, and destination permission.';
  console.error(message);
  process.exitCode = 1;
} finally {
  await dispatcher.close();
}

Prints the exit IP address and its location as JSON.

Tested against a Node 24.14.0 with installed Undici 8.9.0 local mock trace.

Full Node.js guide

ProxyAgent receives a Basic token assembled in memory; the proxy URL contains no credential. Use fetch and ProxyAgent from the same pinned Undici package; built-in Node fetch may expose a different Undici version.

exit-check.mjsPlaywright
import { chromium } from 'playwright';

const password = process.env.DATABAY_PROXY_PASS;
if (!password) throw new Error('DATABAY_PROXY_PASS is required');

const browser = await chromium.launch({
  proxy: {
    server: 'http://gw.databay.co:8888',
    username: 'USERNAME-zone-residential',
    password,
  },
});

const page = await browser.newPage();
await page.goto('https://databay.com/what-is-my-ip/json', {
  waitUntil: 'domcontentloaded',
  timeout: 30_000,
});
console.log(await page.textContent('body'));
await browser.close();

Prints the exit IP address and its location as JSON.

Same shape as the tested cURL, Requests and Undici snippets.

Full Playwright guide

Playwright keeps the proxy server, username, and password in dedicated fields. The proxy belongs to the browser or context. Cookies, storage, locale, and device state remain separate inputs.

exit_check_spider.pyScrapy
import os
from urllib.parse import quote
import scrapy

username = quote("USERNAME-zone-residential", safe="")
password = quote(os.environ["DATABAY_PROXY_PASS"], safe="")
proxy_url = f"http://{username}:{password}@gw.databay.co:8888"

class ExitCheckSpider(scrapy.Spider):
    name = "exit_check"

    async def start(self):
        yield scrapy.Request(
            "https://databay.com/what-is-my-ip/json",
            meta={"proxy": proxy_url, "download_timeout": 30},
        )

    def parse(self, response):
        self.logger.info(response.text)

Prints the exit IP address and its location as JSON.

Same shape as the tested cURL, Requests and Undici snippets.

Full Scrapy guide

Scrapy HttpProxyMiddleware reads the encoded URL from request.meta and creates proxy authorization. The standard HTTP download handler supports this HTTP proxy path; connection reuse can preserve an exit across requests.

Using Selenium? Standard WebDriver cannot answer a proxy password challenge, so allowlist the runner’s IP instead. The config generator writes that setup.

Browse setup guides for every tool

Gateway

One host. The username does the routing.

Host, port and password stay the same on every network. Change one word in the username to change the network, the country or the session.

Host and port
gw.databay.co:8888
Protocols
HTTP, HTTPS CONNECT and SOCKS5 on the same port
Authentication
Proxy username and password, or a source IP you allowlist in the dashboard
Username formatBrackets mark optional parts.
USERNAME-zone-{zone}[-countryCode-{cc}][-sessionId-{id}[-sessionLength-{minutes}]]

Two real usernames

  • Rotating, United StatesUSERNAME-zone-residential-countryCode-us
  • Sticky for 30 minutes, GermanyUSERNAME-zone-residential-countryCode-de-sessionId-job%2D42-sessionLength-30

Routing keys

zoneRequired
residential · residential_FLEX · datacenter · mobile
Picks the network. Change this word to switch networks; the gateway and the password stay the same.
countryCodeOptional
Two-letter ISO code, lowercase (us, de, jp)
Routes to an exit in that country where we have exits. One targeting selector per request.
sessionIdOptional
3 to 32 letters, digits or hyphens
Reuse an ID to request the same exit across connections during its session window. Hyphens inside the value are sent as %2D so they never read as a new key.
sessionLengthOptional, with sessionId
Whole minutes, subject to route availability
Requests an exit continuity window. The gateway also accepts sessionMaxDuration as an alias. The IP can change before the window ends.
hardSessionIdOptional, where available
1 to 128 letters, digits, hyphens or underscores
Requests the same residential exit for as long as possible. The IP can change. Choose a new ID when changing the location. Use hardSessionId without sessionId, sessionLength or os. Encode hyphens inside the ID as %2D.
osOptional, where available
windows, android, ios, macos
Targets residential exits associated with the selected operating system. The dashboard shows which locations are available with this option. Hard Session and OS targeting are mutually exclusive.

Premium Residential also accepts finer selectors (state, city, ZIP, coordinates or ASN), one per request. The config generator writes cityName and asNumber for you; the documentation lists the rest.

Account API

Users, traffic and allowlists from your own code.

Everything the dashboard does for sub-users, traffic and allowlists has a v1 route. Send your account token as Authorization: Bearer; every route, field, error and rate limit is in the reference.

API reference(opens in a new tab)Documentation(opens in a new tab)

  1. POST

    Create a proxy user

    Credentials for a teammate, a client or a job, with its own quota.

    /api/v{version}/accounts/{accountId}/proxy-users
  2. POST

    Allocate bandwidth

    Move purchased traffic to that user with a product and an expiry.

    /api/v{version}/accounts/{accountId}/proxy-users/{proxyUserId}/bandwidths
  3. GET

    Read usage

    Traffic records per proxy user for your own metering and alerts.

    /api/v{version}/accounts/{accountId}/proxy-users/{proxyUserId}/bandwidths/logs
  4. POST

    Manage allowlists

    Add source IPs that may connect without a password; list and remove them the same way.

    /api/v{version}/accounts/{accountId}/proxy-users/{proxyUserId}/whitelisted-ips

Behaviour

Limits in plain words.

What the network does by default, so your client is built for it.

Concurrency
No fixed cap
No fixed concurrent-connection limit in normal use. Anti-abuse protections can apply.
Rotation
Per new connection
A new connection selects from the shared pool; a reused keep-alive connection retains its exit. Change the session ID to start a separate session.
Sticky maximum
1440 minutes
Request up to 1440 minutes on Premium Residential and Residential Flex where available, or up to 120 minutes on Datacenter and Mobile. The IP can change before the window ends.
Targeting
One selector
One selector per request, routed where we have exits. Premium Residential: country, state, city, ZIP, coordinates or ASN. Residential Flex, Datacenter and Mobile: country or continent.
Account API rate limits
Per route
Documented per route in the API reference. Back off on a 429 response and retry the same request.
Protocols
One gateway
HTTP, HTTPS CONNECT and SOCKS5 on one port. An HTTPS destination goes through CONNECT on the HTTP proxy; SOCKS5 adds no encryption of its own. Eligible Premium Residential routes support HTTP/3 over QUIC with a client that supports SOCKS5 UDP ASSOCIATE.

FAQ

Developer questions

Short answers to what developers ask before the first order.

Is there an SDK?

No, and you do not need one. Any HTTP, HTTPS or SOCKS5 client that accepts a proxy with a username and password works, and the account API is plain JSON over HTTPS.

How do I get a new IP?

Use a new connection for shared-pool rotation; a reused keep-alive connection retains its exit. Change the session ID to start a separate session.

How do I keep the same IP?

Add sessionId to the username and use sessionLength or its alias sessionMaxDuration to request a window in whole minutes. With a session ID, omitting the duration requests 360 minutes on Premium Residential and Residential Flex. An invalid value or a value above 1440 requests 1440 minutes on those networks. On Datacenter and Mobile, omission or an invalid value requests 45 minutes, and values above 120 use 120. The requested duration still depends on route availability. Reuse the same ID, targeting and duration to request continuity across connections. The IP can change before the window ends.

Can I create credentials for teammates or customers?

Yes. Create proxy users with their own credentials and traffic quotas from the dashboard or the API, then read their usage logs.

How do I verify which exit I got?

Send one request to https://databay.com/what-is-my-ip/json through the proxy. The JSON response shows the exit IP and its location, so you can check the country before the real job starts.

Can I test before buying?

Eligible accounts get 1 GB of Residential Flex free for 7 days after card setup; otherwise 5 GB of Premium Residential is $13.75. Switching between the two is a one-word change in the username.

Get started

Get credentials.
Send the first request.

Credentials appear in the dashboard the moment the trial starts or payment clears. Paste them into any snippet above and run it to see your exit.

Free trial

$0

1 GB free for 7 days. Card required. From day 7, automatic top-ups of 25 GB for $13.75 unless you turn them off.

One trial per customer.

Pay as you go

$13.75

5 GB of Premium Residential

$2.75/GB · valid 186 days

Buy once, or top up automatically.

See all plansNeed a terabyte a month? Get a written quote