Getting Started with ZentisLabs Proxies

1Create Your Account

1. Navigate to zentislabs.com/auth/register and sign up with your email
2. Verify your email with the 6-digit code sent to your inbox
3. Log in to the dashboard - verified accounts get 100 MB of Residential Basic free to test (eligibility checks apply)
4. Explore the dashboard: Generate Proxy, Billing, Settings

2Get Your API Key

1. Open Dashboard → Settings
2. Your API key is already there: every account gets one automatically
3. Copy it - it starts with zl_live_ followed by 48 hex characters
4. Store it securely. If it ever leaks, click Regenerate and the old key stops working instantly

# Add to your .env or secrets manager
export ZENTISLABS_API_KEY="zl_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.

# Use your proxy credentials from the dashboard
# Basic plan: targeting goes in the password (_country-de = Germany)
curl -x "http://USERNAME:PASSWORD_country-de@basic.resi.zentislabs.com:12321" \
  "https://httpbin.org/ip"

import requests

# Use your proxy credentials from the dashboard (_country-de = Germany)
PROXY = "http://USERNAME:PASSWORD_country-de@basic.resi.zentislabs.com:12321"

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

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

// Use your proxy credentials from the dashboard (_country-de = Germany)
const PROXY_URL = 'http://USERNAME:PASSWORD_country-de@basic.resi.zentislabs.com:12321';

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

Each example prints your proxy's exit IP. To generate lines from code instead of copying them from the dashboard, call POST https://api.zentislabs.com/api/v1/proxies/generate with your API key and a body such as {"provider": "basic", "country": "DE", "count": 2}. A successful call returns ready-to-use lines; split each one on its first three colons into host, port, username and password:

{
  "success": true,
  "proxies": [
    "basic-eu.resi.zentislabs.com:12321:USERNAME:PASSWORD_country-de",
    "basic-eu.resi.zentislabs.com:12321:USERNAME:PASSWORD_country-de"
  ]
}

Common Issues & Troubleshooting

Production Best Practices