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
- Your client





- HTTP · HTTPS CONNECT · SOCKS5
gw.databay.co:8888Reads the route from the username- zone · country · session
- ExitOn the network and in the country you named
Account API
- Your backend
Authorization: Bearer - JSON over HTTPS
- Account API v1Every dashboard action for sub-users
- REST routes
- Your accountProxy users · bandwidth · usage · allowlists
Quickstart
Your first request in three steps.
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.
Name the route in the username.
The word after
zone-picks the network andcountryCode-the country. AddsessionId-to keep one exit across connections.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.
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.
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 Requestsimport 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.
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 / Undiciimport { 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.
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.mjsPlaywrightimport { 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.
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.pyScrapyimport 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.
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 toolGateway
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-zone-{zone}[-countryCode-{cc}][-sessionId-{id}[-sessionLength-{minutes}]]Two real usernames
- Rotating, United States
USERNAME-zone-residential-countryCode-us - Sticky for 30 minutes, Germany
USERNAME-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.
Zones
Four networks behind one password. Switching is a one-word change.
- Premium ResidentialHome broadband IPs
zone-residentialCountry, state, city, ZIP, coordinates or ASNSticky up to 1440 min - Residential FlexHome IPs by country
zone-residential_FLEXCountry or continentSticky up to 1440 min - Mobile4G and 5G carrier IPs
zone-mobileCountry or continentSticky up to 120 min - DatacenterServer IPs
zone-datacenterCountry or continentSticky up to 120 min
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)
- 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 - POST
Allocate bandwidth
Move purchased traffic to that user with a product and an expiry.
/api/ v{version}/ accounts/ {accountId}/ proxy-users/ {proxyUserId}/ bandwidths - GET
Read usage
Traffic records per proxy user for your own metering and alerts.
/api/ v{version}/ accounts/ {accountId}/ proxy-users/ {proxyUserId}/ bandwidths/ logs - 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.
See all plansNeed a terabyte a month? Get a written quote