X-License-Key
Preferred header. Authenticates the request and selects your credit wallet.
Call the engine base URL with your license key. Unlock returns JSON (or NDJSON when you stream). Check balance on GET /license. List live provider costs on GET /pricing.
Three steps before your first unlock call. The same key and credit wallet work across every Bypass Lab surface.
Buy a Bypass Lab license on Telegram or Discord. The same key works for website, Chrome extension, Telegram bot, and HTTP API.
Top up tokens so the key has balance. 5,000 tokens for $5. Credits charge only after a successful unlock.
Send X-License-Key (or Authorization Bearer) and JSON {"url":"<full https link>"}. Read destination and creditsCharged from the response.
Every unlock and license read needs your Bypass Lab license key. Pricing is public and does not require a key.
Replace YOUR_LICENSE_KEY with your Bypass Lab license. You can also send Authorization: Bearer YOUR_LICENSE_KEY. Optional: send X-Request-Id (for example a UUID) when you retry the same unlock so billing stays idempotent.
https://bypasslab-engine.edge-workspace.workers.devX-License-Key: YOUR_LICENSE_KEY Content-Type: application/json
Preferred header. Authenticates the request and selects your credit wallet.
Same key value as Bearer token. Do not mix this with engine service keys.
Optional idempotency key for unlock billing. Reusing the same id after a successful debit does not charge again.
Unlock a supported http or https URL. JSON mode returns one object. Stream mode emits NDJSON events until done, password, or error.
Full http or https link to unlock.
Link password when the host paused for one on a prior call.
When true, respond with application/x-ndjson events. You can also set Accept: application/x-ndjson.
When true, skip a cached destination and run a fresh unlock.
curl -sS https://bypasslab-engine.edge-workspace.workers.dev/bypass \ -H "X-License-Key: YOUR_LICENSE_KEY" \ -H "Content-Type: application/json" \ -H "X-Request-Id: $(uuidgen)" \ -d '{"url":"https://linkvertise.com/882105/locked-download"}'
curl -sS -N https://bypasslab-engine.edge-workspace.workers.dev/bypass \ -H "X-License-Key: YOUR_LICENSE_KEY" \ -H "Content-Type: application/json" \ -H "Accept: application/x-ndjson" \ -d '{"url":"https://linkvertise.com/882105/locked-download","stream":true}'
{
"ok": true,
"destination": "https://example.com/destination",
"destinationKind": "url",
"hops": 2,
"provider": "Linkvertise",
"elapsedMs": 1400,
"cached": false,
"next": null,
"creditsCharged": 2,
"creditsRemaining": 4610
}Unlock began. Includes provider and url.
One hop finished. Includes hop index, from, to, and elapsedMs.
Keepalive while the unlock is still running (for: unlock).
Success. Same fields as the JSON success body, plus type: done.
Host needs a password. Includes provider. Collect input and retry.
Unlock failed. Includes error. Billing failures may include balance and cost.
Some hosts pause until the end user enters a password. Your app collects that input and sends it on a second POST /bypass. Image captchas are solved on the server for licensed API calls—you do not submit captcha tokens.
Call POST /bypass with {"url":"<link>" } (no password yet).
JSON mode returns HTTP 401 with {"ok": false, "needsPassword": true, "provider": "…" }. Stream mode emits {"type": "password", "provider": "…" } then closes.
Ask the end user for the link password in your UI.
Call POST /bypass again with the same url and {"password": "<what they typed>" }.
Wrong password fails the unlock (no credit charge). Collect a new password and retry.
curl -sS https://bypasslab-engine.edge-workspace.workers.dev/bypass \ -H "X-License-Key: YOUR_LICENSE_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"https://linkvertise.com/882105/locked-download","password":"user-password"}'
Read remaining credits, channel totals, and recent ledger entries for the authenticated key.
curl -sS https://bypasslab-engine.edge-workspace.workers.dev/license \ -H "X-License-Key: YOUR_LICENSE_KEY"
{
"ok": true,
"license": {
"keyPrefix": "BYPASSLAB",
"status": "active",
"balance": 4610,
"createdAt": "2026-01-01T00:00:00.000Z"
},
"totals": {
"toppedUp": 5000,
"used": 390,
"byChannel": {
"website": 100,
"extension": 200,
"api": 50,
"telegram": 40
}
},
"entries": []
}Public list of live providers with cost, hosts, and whether the host is extension-only. No license header required.
curl -sS https://bypasslab-engine.edge-workspace.workers.dev/pricing{
"ok": true,
"providers": [
{
"providerId": "linkvertise",
"id": "linkvertise",
"kind": "bypass",
"name": "Linkvertise",
"cost": 2,
"extensionOnly": false,
"websiteFree": true,
"hosts": [
"linkvertise.com"
]
}
]
}Buy on Telegram or Discord. 5,000 tokens for $5. Credits charge only after a successful unlock.
Error responses use {"ok": false, "error": "…" }. Password pauses also return 401 with needsPassword: true.
Bad URL or no API handler for that host.
Missing or invalid license key, or password required.
Not enough credits (balance and cost may be included).
License revoked or unavailable on GET /license.
Upstream unlock failed. Retry or report the URL.
License headers, wallets, supported hosts, and how API unlock differs from free website unlock.
Manage LicenseYour Bypass Lab license key. Send it as X-License-Key, or as Authorization: Bearer with the same value. That key opens the HTTP API and selects your credit wallet.
Yes. One Bypass Lab license key holds the wallet for website, Chrome extension, Telegram bot (after /license), and this API. Website visitors without a license stay on the free rate-limited path. Extension and HTTP API always need the license.
The same live website and Telegram API providers: ad links, social unlocks, URL shorteners, link wrappers, file hosts, and content unlocks. Chrome-extension-only hosts are not available over the HTTP API or Telegram bot; check each bypass guide. Free or credit labels show under Bypass Providers, on each guide, and on GET /pricing.
Free website unlocks are rate-limited and may show captcha and ads. The HTTP API unlocks with your license, without website ads or captcha, and charges credits only after success.
Add your license, buy tokens when you need credits, then POST /bypass with a supported URL. Use GET /license to confirm balance.