5-minute onboarding

Getting Started with ZentisLabs Proxies

This guide takes you from account creation to your first authenticated proxy request with enterprise-ready defaults. Follow the three steps below and you will be routing traffic through 100+ MIO residential IPs in under five minutes.

195+ countries 100+ MIO IPs <0.5s latency

Create your account

Get your API key

Go to Settings → API Keys, create a key, and copy it somewhere safe.

Generate & use proxies

Use cURL, Python, or Node.js to route traffic through a proxy pool and verify geo/IP behavior immediately.

1Create Your Account

Navigate to zentislabs.com/auth/register and sign up with your email
Verify your email with the 6-digit code sent to your inbox
Log in to the dashboard — you start with free bandwidth to test
Explore the dashboard: Generate Proxy, Billing, Settings

Pro tip: Bookmark the dashboard — you'll use it to generate proxies and manage your account.

2Generate API Credentials

Open Dashboard → Settings → API Keys
Click "Create API Key" and give it a name (e.g., "Production")
Copy the generated key — it starts with zlk_live_
Store it securely — you won't be able to see it again

Environment variable

# Add to your .env or secrets manager
export ZENTISLABS_API_KEY="zlk_live_a1b2c3d4e5f6..."

3Send Your First Proxy Request

Choose your preferred language below. Each example resolves a residential proxy in Germany and makes a test request.

cURL

bash

# Use your proxy credentials from the dashboard
# Format: http://USERNAME:PASSWORD@gate.zentislabs.com:8080
curl -x "http://zl_residential_de_rotating_abc123:yourpassword@gate.zentislabs.com:8080" \
  "https://httpbin.org/ip"

Python

python

import requests

# Use your proxy credentials from the dashboard
PROXY = "http://USERNAME:PASSWORD@gate.zentislabs.com:8080"

proxies = {"http": PROXY, "https": PROXY}
response = requests.get("https://httpbin.org/ip", proxies=proxies)
print(f"Your proxy IP: {response.json()['origin']}")

Node.js

typescript

import axios from 'axios';
import { HttpsProxyAgent } from 'https-proxy-agent';

// Use your proxy credentials from the dashboard
const PROXY_URL = 'http://USERNAME:PASSWORD@gate.zentislabs.com:8080';

const agent = new HttpsProxyAgent(PROXY_URL);
const { data } = await axios.get('https://httpbin.org/ip', {
  httpsAgent: agent
});
console.log(`Your proxy IP: ${data.origin}`);

✓Validate the Response

A successful proxy resolution returns a JSON object like this:

json — successful response

{
  "host": "gate.zentislabs.com",
  "port": 8080,
  "username": "zl_residential_de_rotating_abc123",
  "password": "generated-password",
  "protocol": "http"
}

session

Your sticky session ID. Same session = same IP for the duration of the TTL.

ttl

Time-to-live in seconds. After TTL expires, a new IP is assigned on next request.

type

Proxy type: residential, isp, mobile, or datacenter.

country / city

Geo-location of the assigned proxy IP, matching your targeting request.

Common Issues & Troubleshooting

401

Unauthorized

Cause: Invalid or expired API key

Fix: Generate a new API key from Dashboard → Settings → API Keys.

403

Forbidden

Cause: Access denied

Fix: Check that your API key is valid and has not been revoked.

429

Rate Limited

Cause: Too many requests per second

Fix: Implement exponential backoff. Consider upgrading your plan for higher rate limits.

503

Pool Exhausted

Cause: No available proxies in the requested geo

Fix: Expand geo-targeting (e.g., country-level instead of city), or switch to a larger proxy pool.

Production Best Practices

🔐 Secure Credentials

Store API keys in environment variables or a secrets manager. Never hardcode keys in source code or expose them in frontend bundles.

🔄 Implement Retries

Use exponential backoff with jitter for 429/5xx errors. Retry on a different proxy pool for the final attempt.

📊 Monitor Usage

Track bandwidth consumption, success rates, and error rates via the dashboard or API to stay within budget and detect issues early.

🌍 Use Sessions Wisely

Use sticky sessions for multi-step workflows (login → checkout). Use rotating sessions for high-volume scraping to maximize IP diversity.

Authentication Guide →

Learn about API keys and authentication methods.

Proxy Configuration →

Set up pools, geo-targeting, rotation, and failover policies.

Code Examples →

Production-ready Python, Node.js, and cURL code examples.

Residential Proxies →

100M+ IPs across 195+ countries with rotating and sticky sessions.