Managed Proxies

Route browsers through residential IPs — from our managed proxies, or bring your own.

Managed residential proxies

Paid plans include managed residential proxies. Claim one, bind it to a profile, and launch. Usage is metered per month (see below).

Bring your own

Pass any protocol://user:pass@host:port URL to launch(). Your own proxies are never metered.

Plan Quotas

Each plan allows a number of distinct proxies used per month (N). You may hold up to 2×N at once (claiming/holding is always free).

Plan	Distinct proxies / month (N)	Hold cap (2×N)
FREE	0	0
BASIC	2	4
PRO	5	10
TEAM	20	40

Acquisition

Claim (free)

Take an available managed proxy. It becomes stickily assigned to you. Claiming never consumes monthly quota — you can hold up to 2×N.

Release

Return a held managed proxy, freeing a hold slot.

Swap

Return one proxy and claim a new one in a single step.

Metering & Reset

Metering is by monthly active use: holding is free; launching is what counts.

Launching a profile with a managed proxy meters one distinct proxy for the current month.

Re-launching the same proxy in the same month is free (it only updates last-used/launch count).

Once you have used N distinct proxies this month, activating a new one returns 403 (monthly quota exceeded).

Monthly auto-reset: metering uses a UTC calendar month (YYYY-MM). At month start the count resets to zero automatically — proxies you keep using are admitted again, proxies you stop using simply free up.

Claiming, holding, and binding never meter. Bring-your-own proxies never meter.

API Reference

All endpoints require Authorization: Bearer <api-key>.

GET/api/v1/proxies

List your assigned proxies + monthly quota: limit, usedThisMonth, remaining, holdCount, holdCap.

POST/api/v1/proxies

Manage your holdings via an action body:

{ action: 'claim' } — claim an available managed proxy (free)
{ action: 'release', proxyId } — release a held managed proxy
{ action: 'swap', proxyId } — swap for a new one

POST/api/v1/proxies/:id/activate

Meter + activate before launch. Idempotent within a month for the same (user, proxy). Returns 403 when the monthly limit is exceeded. The SDK calls this automatically when you pass proxyId.

Usage

From the SDK

import { listProxies, claimManagedProxy } from 'anti-detect-browser'

// See your managed proxies + quota
const { quota } = await listProxies({ key })
// { limit, usedThisMonth, remaining, holdCount, holdCap }

// Claim is free — does not touch monthly quota
const proxy = await claimManagedProxy({ key })

// Launching with proxyId meters one distinct proxy for the month
await ab.launch({ profile: 'acc-01', proxyId: proxy.id })

// Bring your own proxy — never metered
await ab.launch({
  proxy: 'socks5://user:pass@us-proxy.example.com:1080',
  profile: 'us-account',
})

From the desktop app

On the Proxies page, claim a managed proxy (or add your own), then bind it to a profile in the create/edit dialog. Launching the profile meters the proxy for the month, exactly like the SDK. See the desktop walkthrough →