Welcome

Everything you need to use LittenProxy — residential and datacenter proxies on one network, billed by the gigabyte. Below is the full REST API and how to connect to the proxy.

Base URL

base

https://littencaptcha.com/api/v1

Every endpoint below is relative to this base. All requests and responses are JSON over HTTPS. The unversioned /api prefix still works as a deprecated alias.

Authentication

Two methods are supported. For scripts and servers, use an access token as a Bearer header. The dashboard itself uses a signed session cookie set by /login.

Access tokens (recommended)

Create a token in the dashboard under Settings → API access tokens. The full token is shown once; only its SHA-256 is stored. Send it on every request:

header

Authorization: Bearer lp_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Treat tokens like passwords. A token has full access to its account. Revoke it any time — revocation is immediate.

Session cookie

Calling POST /login returns a Secure; HttpOnly; SameSite=Lax cookie named mesh_session, valid for 7 days. Browsers send it automatically.

Errors

Errors use standard HTTP status codes and a JSON body with a single error field.

example

{ "error": "Invalid email or password" }

Status	Meaning
400	Bad request — missing or invalid parameters
401	Not authenticated, or invalid credentials / token
404	Resource not found
429	Rate limited — slow down and retry
500	Server error

Rate limits

Authentication endpoints are rate limited per IP. Exceeding the limit returns 429.

Endpoint	Limit
POST /login	10 requests / minute
POST /signup	5 requests / 5 minutes

Get account

GET/meAuth required

Returns your account, balance and the current proxy credentials.

curl

curl https://littencaptcha.com/api/v1/me \
  -H "Authorization: Bearer $LP_TOKEN"

200 response

{
  "username": "601d7f1d05cb8953aefe",   // proxy code (login for the proxy)
  "email": "you@example.com",
  "proxyPassword": "b695b157e5719e6e902f2b52",
  "tier": "datacenter",
  "tierName": "Datacenter",
  "balance_bytes": 3000000000,
  "used_bytes": 124500000,
  "unlimited": false,
  "host": "gw.littencaptcha.com",
  "port": 8080
}

Change login password

POST/account-passwordAuth required

Changes your account sign-in password. This is separate from the proxy password — changing it does not affect the proxy.

Field	Type	Description
current	string	Current login passwordrequired
new	string	New password, min 8 charactersrequired

curl

curl -X POST https://littencaptcha.com/api/v1/account-password \
  -H "Authorization: Bearer $LP_TOKEN" -H "Content-Type: application/json" \
  -d '{"current":"old-pass","new":"new-strong-pass"}'

200 response

{ "ok": true }

Usage

GET/usageAuth required

Daily traffic (bytes up + down) for the last 14 days.

200 response

[
  { "date": "2026-09-30", "bytes": 412000000 },
  { "date": "2026-10-01", "bytes": 388500000 }
]

Invoices

GET/invoicesAuth required

Your most recent top-ups, newest first (up to 50).

200 response

[
  {
    "id": "INV-8F10FE57",
    "date": "2026-10-03",
    "gb": 3.0,
    "amt": 1.5,
    "plan": "Datacenter · 3 GB",
    "source": "dashboard"
  }
]

Add balance

POST/topupAuth required

Adds prepaid GB to your balance and records an invoice. Returns the new balance in bytes.

Field	Type	Description
gb	number	GB to add (0 < gb ≤ 100000)required

curl

curl -X POST https://littencaptcha.com/api/v1/topup \
  -H "Authorization: Bearer $LP_TOKEN" -H "Content-Type: application/json" \
  -d '{"gb":5}'

200 response

{ "balance_bytes": 8000000000 }

Rotate proxy password

POST/rotate-passwordAuth required

Generates a new proxy password and returns it. Your account login is unaffected. The old proxy password stops working immediately.

200 response

{ "password": "b695b157e5719e6e902f2b52" }

Using the proxy

Your proxy username is the code from username, and the password is proxyPassword (both from GET /me). One endpoint serves both HTTP CONNECT and SOCKS5.

Field	Value
host	gw.littencaptcha.com
port	8080
format	host:port:username:password

curl — HTTP

curl -x "http://601d7f1d05cb8953aefe:b695b157e5719e6e902f2b52@gw.littencaptcha.com:8080" \
  https://api.ipify.org

curl — SOCKS5

curl -x "socks5h://601d7f1d05cb8953aefe:b695b157e5719e6e902f2b52@gw.littencaptcha.com:8080" \
  https://api.ipify.org

Traffic is metered per byte against your prepaid balance. When the balance reaches zero, new requests are refused.

List access tokens

GET/keysAuth required

Lists your active tokens. The full token value is never returned — only a masked prefix.

200 response

[
  {
    "id": "8f10fe57-79bb-4fe3-92dd-37e34e085242",
    "name": "CI scraper",
    "prefix": "lp_live_25fe4702…",
    "created": "2026-10-03",
    "lastUsed": "2026-10-03"
  }
]

Create access token

POST/keysAuth required

Creates a token and returns its full value once. Store it now — it cannot be retrieved later. Max 20 active tokens per account.

Field	Type	Description
name	string	Label to identify the token (optional)

curl

curl -X POST https://littencaptcha.com/api/v1/keys \
  -H "Authorization: Bearer $LP_TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"CI scraper"}'

200 response

{
  "id": "8f10fe57-79bb-4fe3-92dd-37e34e085242",
  "name": "CI scraper",
  "token": "lp_live_25fe4702a9424e44a9be2ece2e6eb6a39b50cc12",
  "prefix": "lp_live_25fe4702…"
}

Revoke access token

DELETE/keys/:idAuth required

Revokes a token by its id. The token stops working immediately.

curl

curl -X DELETE https://littencaptcha.com/api/v1/keys/8f10fe57-79bb-4fe3-92dd-37e34e085242 \
  -H "Authorization: Bearer $LP_TOKEN"

200 response

{ "ok": true }

Sign up

POST/signupPublic

Creates an account, generates its proxy code + proxy password, and sets a session cookie.

Field	Type	Description
email	string	Account emailrequired
password	string	Login password, min 8 charactersrequired

200 response

{ "email": "you@example.com" }

Log in

POST/loginPublic

Authenticates by email + password and sets the mesh_session cookie. Use POST /logout to clear it.

curl

curl -X POST https://littencaptcha.com/api/v1/login \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"your-password"}' -c cookies.txt

200 response

{ "email": "you@example.com" }