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 100M+ residential IPs in under five minutes.

195+ countries 100M+ IPs <0.5s latency

Create your workspace

Generate API credentials

Create an API key with least-privilege scope and optional IP allowlisting for server-side traffic.

Send your first request

Use cURL or SDKs to route traffic through a proxy pool and verify geo/IP behavior immediately.

1Create Your Account & Workspace

Navigate to zentislabs.com/auth and sign up with your business email
Create a workspace and name it (e.g., "Production" or "My Company")
Label environments for staging and production to separate traffic from day one
Invite team members and assign roles (Admin, Developer, Viewer)

Pro tip: Use separate workspaces for different projects to keep billing and analytics isolated.

2Generate API Credentials

Open Dashboard → Access Management
Click "Create API Key" and set scope to proxy:read and proxy:write
Enable IP allowlist for backend egress IPs (recommended for production)
Copy the key and store it securely — you won't see it again

Environment variable

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

# Verify the key works
curl -s https://api.zentislabs.com/v1/me \
  -H "Authorization: Bearer $ZENTISLABS_API_KEY" | jq .

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

# Resolve a proxy from the residential pool
curl -X POST "https://api.zentislabs.com/v1/proxies/resolve" \
  -H "Authorization: Bearer $ZENTISLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pool": "residential",
    "country": "DE",
    "session": "quickstart-test-01"
  }'

# Use the returned proxy to check your IP
curl -x "http://USER:PASS@gw.zentislabs.com:14001" \
  "https://httpbin.org/ip"

Python

python

import requests
import os

API_KEY = os.environ["ZENTISLABS_API_KEY"]

# Step 1: Resolve a proxy
resp = requests.post(
    "https://api.zentislabs.com/v1/proxies/resolve",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "pool": "residential",
        "country": "DE",
        "session": "quickstart-test-01"
    }
)
proxy_data = resp.json()
print(f"Proxy: {proxy_data['host']}:{proxy_data['port']}")

# Step 2: Use the proxy
proxies = {
    "http": f"http://{proxy_data['username']}:{proxy_data['password']}@{proxy_data['host']}:{proxy_data['port']}",
    "https": f"http://{proxy_data['username']}:{proxy_data['password']}@{proxy_data['host']}:{proxy_data['port']}"
}
ip_check = requests.get("https://httpbin.org/ip", proxies=proxies)
print(f"Your proxy IP: {ip_check.json()['origin']}")

Node.js

typescript

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

const API_KEY = process.env.ZENTISLABS_API_KEY!;

// Step 1: Resolve a proxy
const { data: proxy } = await axios.post(
  'https://api.zentislabs.com/v1/proxies/resolve',
  { pool: 'residential', country: 'DE', session: 'quickstart-test-01' },
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);

console.log(`Proxy: ${proxy.host}:${proxy.port}`);

// Step 2: Use the proxy
const agent = new HttpsProxyAgent(
  `http://${proxy.username}:${proxy.password}@${proxy.host}:${proxy.port}`
);
const { data: ip } = await axios.get('https://httpbin.org/ip', {
  httpsAgent: agent
});
console.log(`Your proxy IP: ${ip.origin}`);

✓Validate the Response

A successful proxy resolution returns a JSON object like this:

json — successful response

{
  "id": "pxy_7dfb2a4c",
  "host": "gw.zentislabs.com",
  "port": 14001,
  "username": "ws_prod_de_01",
  "password": "generated-pass",
  "country": "DE",
  "city": "Frankfurt",
  "session": "quickstart-test-01",
  "ttl": 600,
  "type": "residential",
  "created_at": "2025-03-01T12:00:00Z"
}

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 → Access Management. Ensure the key has proxy:read scope.

403

Forbidden

Cause: IP not in allowlist

Fix: Add your server's egress IP to the key's allowlist, or disable IP restrictions for development.

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.

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

# Resolve a proxy from the residential pool
curl -X POST "https://api.zentislabs.com/v1/proxies/resolve" \
  -H "Authorization: Bearer $ZENTISLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "pool": "residential",
    "country": "DE",
    "session": "quickstart-test-01"
  }'

# Use the returned proxy to check your IP
curl -x "http://USER:PASS@gw.zentislabs.com:14001" \
  "https://httpbin.org/ip"

Python

python

import requests
import os

API_KEY = os.environ["ZENTISLABS_API_KEY"]

# Step 1: Resolve a proxy
resp = requests.post(
    "https://api.zentislabs.com/v1/proxies/resolve",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "pool": "residential",
        "country": "DE",
        "session": "quickstart-test-01"
    }
)
proxy_data = resp.json()
print(f"Proxy: {proxy_data['host']}:{proxy_data['port']}")

# Step 2: Use the proxy
proxies = {
    "http": f"http://{proxy_data['username']}:{proxy_data['password']}@{proxy_data['host']}:{proxy_data['port']}",
    "https": f"http://{proxy_data['username']}:{proxy_data['password']}@{proxy_data['host']}:{proxy_data['port']}"
}
ip_check = requests.get("https://httpbin.org/ip", proxies=proxies)
print(f"Your proxy IP: {ip_check.json()['origin']}")

Node.js

typescript

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

const API_KEY = process.env.ZENTISLABS_API_KEY!;

// Step 1: Resolve a proxy
const { data: proxy } = await axios.post(
  'https://api.zentislabs.com/v1/proxies/resolve',
  { pool: 'residential', country: 'DE', session: 'quickstart-test-01' },
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);

console.log(`Proxy: ${proxy.host}:${proxy.port}`);

// Step 2: Use the proxy
const agent = new HttpsProxyAgent(
  `http://${proxy.username}:${proxy.password}@${proxy.host}:${proxy.port}`
);
const { data: ip } = await axios.get('https://httpbin.org/ip', {
  httpsAgent: agent
});
console.log(`Your proxy IP: ${ip.origin}`);

Getting Started with ZentisLabs Proxies

Create your workspace

Generate API credentials

Send your first request

1Create Your Account & Workspace

2Generate API Credentials

3Send Your First Proxy Request

cURL

Python

Node.js

✓Validate the Response

session

ttl

type

country / city

Common Issues & Troubleshooting

Unauthorized

Forbidden

Rate Limited

Pool Exhausted

Production Best Practices

🔐 Secure Credentials

🔄 Implement Retries

📊 Monitor Usage

🌍 Use Sessions Wisely

Authentication Guide →

Proxy Configuration →

SDKs & Integrations →

Code Examples →

Getting Started with ZentisLabs Proxies

Create your workspace

Generate API credentials

Send your first request

1Create Your Account & Workspace

2Generate API Credentials

3Send Your First Proxy Request

cURL

Python

Node.js

✓Validate the Response

session

ttl

type

country / city

Common Issues & Troubleshooting

Unauthorized

Forbidden

Rate Limited

Pool Exhausted

Production Best Practices

🔐 Secure Credentials

🔄 Implement Retries

📊 Monitor Usage

🌍 Use Sessions Wisely

Authentication Guide →

Proxy Configuration →

SDKs & Integrations →

Code Examples →