# Web Unlocker API — от 403 к 200 | QuantumProxies.io

Web Unlocker API и прокси: резидентный IP, TLS-отпечаток настоящего браузера, новый выход при каждом отказе и настоящий браузер для JavaScript-проверок.

## Web Unlocker API для страниц, которые отказывают вашему скраперу

Вы отправляете URL, мы возвращаем страницу, которая ответила 403: резидентный IP, TLS-отпечаток настоящего браузера, новый выход при каждом отказе и настоящий браузер, когда сайт требует JavaScript. В ответе есть статус, попытки, время и стоимость, так что вы всегда знаете, что произошло.

- **88.9%** вызовов вернули настоящую страницу
- **4.1 s** медианное время до страницы (p50)
- **27** целей под антибот-защитой, по 3 прогона каждая

Измерено 2026-11-11 нашим собственным canary: 72 из 81 вызовов. Демо-страницы с капчей запускаются, но не учитываются, потому что интерактивные капчи не решаются.

![Web Unlocker QuantumProxies: один POST на /api/v1/scraper/unlock с URL и страной, запрос переотправлен с резидентного IP под TLS-отпечатком браузера с настоящим браузером наготове, и страница, ответившая 403, возвращается как 200 OK со статусом, флагом blocked, победившим уровнем и журналом попыток.](https://quantumproxies.io/images/web-unlocker/web-unlocker-403-to-200.webp?v=20261104)

## От 403 к 200, измерено

### Что получает ваш клиент

**403**

403, проверку безопасности или JavaScript-вызов вместо страницы, каким бы чистым ни был IP и какой бы User-Agent вы ни поставили.

### Что вернул Web Unlocker 2026-11-11

**200**

88.9% из 81 вызовов к 27 защищённым целям вернулись настоящей страницей: медиана 4.1 с, p95 28.8 с.

Наш собственный canary, а не цифра из буклета: те же цели, по 3 прогона каждая. Прогон повторяется, и каждое число на этой странице заново генерируется из его файла.

### Доля успеха по антибот-системам

Сгенерировано из прогона canary от 2026-11-11, 3 прогона на тех же целях. Страницы с интерактивной капчей исключены.

| Антибот-система | Успех | Медианное время | Вызовы |
| --- | --- | --- | --- |
| Cloudflare | 100% | 8.9 s | 9 |
| DataDome | 91.7% | 10.4 s | 12 |
| Akamai | 75% | 2.4 s | 12 |
| PerimeterX / HUMAN | 100% | 1.8 s | 9 |
| Kasada | 100% | 16.1 s | 6 |
| F5 BIG-IP | 100% | 3.4 s | 6 |
| Imperva | 83.3% | 7.4 s | 6 |
| AWS WAF | 66.7% | 14.3 s | 6 |
| Amazon | 66.7% | 4.1 s | 3 |
| Google | 66.7% | 7.5 s | 3 |
| Other sites | 100% | 2.0 s | 6 |
| Reddit | 100% | 1.7 s | 3 |

### Как мы измеряем

Эти цифры получены нашим собственным canary: прогоном, который мы повторяем на одних и тех же страницах. Клиентский трафик в него никогда не входит.

- Фиксированный список защищённых страниц, сгруппированных по системе защиты.
- Прогонов по всему списку: 3.
- Вызов считается успешным, только если возвращает настоящую страницу со статусом 200.
- Страницы с проверкой, пустые ответы и тайм-ауты считаются неудачами.
- Демо-страницы с капчей тоже запускаются, но в подсчёт не входят.

**Последний прогон: 2026-11-11. Страниц: 27, прогонов на каждую: 3, вызовов: 81, настоящих страниц: 72 (88.9%).**

- [Скачать файл данных этого прогона (JSON)](https://quantumproxies.io/data/unlocker-canary.json)
- [Страница статуса в реальном времени](https://quantumproxies.io/web-unlocker/status)

## Какой продукт вам нужен

Три продукта делят одну резидентную сеть. Какой вызывать, зависит от того, что цель делает с вашим запросом.

### Web Unlocker

Страница отказывает вашему клиенту кодом 403, проверкой безопасности или вызовом: один запрос возвращает настоящий ответ, любым методом, с вашими заголовками и телом, с логином или корзиной на одном выходе, с оплатой за ГБ с предоплаченного баланса.

### [Резидентные прокси](https://quantumproxies.io/ru/residential-proxies)

Ваш клиент уже проходит, и нужен только другой IP: резидентный выход с той же грамматикой имени пользователя (страна, штат, город, сессия) по HTTP или SOCKS5.

### [Extract API](https://quantumproxies.io/ru/extract-api)

Вам нужна страница как Markdown, текст или JSON, и не нужны сырой ответ, POST или собственный cookie jar.

## Какой эндпоинт

Один движок за тремя дверями. Выбирайте по тому, на чём уже говорит ваш код; сниппеты те же, что панель заполняет вашими данными.

### REST API

Вы можете менять свой код: один JSON-вызов на входе, один JSON-ответ на выходе, никакого сертификата.

`POST https://app.quantumproxies.io/api/v1/scraper/unlock`

```
curl -X POST https://app.quantumproxies.io/api/v1/scraper/unlock \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/", "country": "us"}'
```

### Прокси (CONNECT)

У вас уже есть скрапер, который говорит по-прокси: направьте его на хост и порт с пользователем и паролем unlocker и установите CA один раз.

`http://unlock.quantumproxies.io:9000`

```
# once: curl -o unlocker-ca.pem https://app.quantumproxies.io/api/v1/scraper/unlock/ca
curl --proxy http://unlock.quantumproxies.io:9000 \
  --proxy-user "USER:PASS" \
  --cacert unlocker-ca.pem \
  https://example.com/
```

### Прямой режим

Прокси без сертификата: отправьте запрос на http://unlock/ через прокси и укажите цель в заголовке x-qp-url.

`http://unlock.quantumproxies.io:9000, then http://unlock/`

```
curl --proxy http://unlock.quantumproxies.io:9000 \
  --proxy-user "USER:PASS" \
  -H "x-qp-url: https://example.com/" \
  http://unlock/
```

## Действия в браузере, пакеты, кэш и готовые клиенты

### Действия в браузере перед снимком страницы

В REST-вызове можно перечислить, что браузер делает до получения страницы: клик, ввод текста, прокрутка, ожидание.

### Пакеты до 100 URL

Отправьте до 100 URL одним пакетом и получите вебхук, когда они завершатся.

### Кэш со сроком жизни на ваш выбор

Вы сами задаёте, сколько страница хранится в кэше. Пока она в кэше, повторный запрос той же страницы ничего не стоит.

### Два клиента для скачивания и таблица миграции

В документации есть два клиента в одном файле каждый, для Node.js и для Python, и таблица миграции для кода, написанного под другой unlocker.

[Открыть документацию Web Unlocker](https://quantumproxies.io/docs/#tag/Web-Unlocker)

## Видео: Web Unlocker в панели

Обзор страницы Web Unlocker в панели: купите ГБ, выберите способ подключения и отправьте первый запрос. На английском, с субтитрами.

## Как работает Web Unlocker

### 1 · Ваш запрос уходит как браузер

Идентифицирующие заголовки вашего клиента (User-Agent, Accept, Sec-Fetch-*) заменяются набором, согласованным с TLS-рукопожатием настоящего браузера. Authorization, cookies, content type и собственные заголовки проходят нетронутыми.

### 2 · Отказ повторяется на свежем резидентном выходе

Вызов или 403 запускает повтор на новом выходе под другим семейством отпечатков, до трёх TLS-попыток, всё в одном бюджете времени: 60 секунд по умолчанию, до 120 с timeout_ms.

### 3 · Всё ещё заблокировано? Подключается настоящий браузер

Когда TLS-уровень продолжает получать вызовы, настоящий браузер открывает страницу и отвечает на JavaScript-вызов. Со sticky-сессией полученный clearance сохраняется и переиспользуется в ваших следующих запросах к этому сайту.

Web Unlocker API нужен для страниц, которые обычный HTTP-клиент получить не может: тех, где антибот-слой оценивает TLS-рукопожатие и настройки HTTP/2 ещё до того, как прочитает хоть один заголовок. Вызов fetch или requests несёт сигнатуру своей среды выполнения, какой бы User-Agent он ни ставил. Unlocker исправляет это на транспортном уровне, повторяет на свежем резидентном выходе, когда origin отказывает, открывает настоящий браузер, когда требуется JavaScript, и отдаёт сырой ответ origin: любой метод, ваши заголовки и тело, логин или корзина на одном IP выхода.

## Что делает web unlocker и чего не делает прокси

Ротирующий резидентный прокси меняет то, откуда приходит запрос. Он не меняет то, как запрос выглядит: TLS-рукопожатие, порядок кадров HTTP/2 и набор заголовков по-прежнему говорят Python или Node, и именно это оценивают современные антибот-стены. Web unlocker переписывает запрос в такой, какой отправил бы настоящий браузер, повторяет под другим отпечатком, когда origin отказывает, и переключается на настоящий браузер, когда origin требует JavaScript. Вы сохраняете интерфейс прокси; unlocker добавляет суждение.

## TLS-отпечатки настоящих браузеров

Каждая попытка уходит под TLS-профилем настоящего браузера с переписанными под него идентифицирующими заголовками, потому что рукопожатие Chrome с User-Agent Firefox — сигнал громче, чем каждый из них по отдельности. Закрепите профиль (Chrome, Firefox, Safari, Safari iOS, Edge, Brave или мобильный Safari на REST-эндпоинте), когда сайт ожидает именно его; не закрепляйте ничего, и повторы чередуются между Chrome, Firefox и Brave, так что сайт, спаливший одно рукопожатие, встречает другое. Authorization, Cookie, Content-Type и собственные заголовки X-* передаются как есть, а keepHeaders отправляет ваши без изменений, когда вы воспроизводите перехваченный запрос приложения.

## Режимы, форматы и бюджет времени

mode auto, режим по умолчанию, поднимается по лестнице: сначала TLS-уровень, свежий выход при отказе, браузер, когда сайт продолжает бросать вызовы. mode tls никогда не открывает браузер; mode browser начинает в нём. format возвращает тело как html, markdown или text, а render png делает скриншот. Весь вызов, включая повторы и рендеринг, укладывается в один бюджет: 60 секунд по умолчанию, до 120 с timeout_ms, а max_bytes ограничивает трафик, который может переместить один вызов. Ответ говорит, какой уровень победил (tier_served), перечисляет каждую попытку с уровнем, профилем, страной выхода, исходом, миллисекундами и байтами (attempt_log) и печатает стоимость в байтах и долларах по цене вашего уровня.

## Блокировка сообщается, а не маскируется под успех

Каждый ответ классифицируется до того, как попадёт к вам. Классификатор читает то, чем системы защиты от ботов подписывают свои страницы, и называет и систему (Cloudflare, DataDome, Akamai, PerimeterX и другие), и класс блокировки: js_challenge, captcha, access_denied, rate_limited, fingerprint, geo или timeout. На REST-эндпоинте всё ещё заблокированная страница приходит как 200 с blocked равным true и самой страницей для изучения, либо как 424 target_blocked, если вы задали fail_on_block. На forward-прокси статус origin передаётся с заголовком x-qp-unlocker-blocked. Интерактивные капчи не решаются: они возвращаются с меткой captcha.

## Сессии, геотаргетинг и память по сайтам

Передайте страну, а также штат или город там, где они есть у сети, чтобы выходить из этого рынка. Оставьте пустым, и страна выхода читается из домена верхнего уровня цели, затем из страны вашего аккаунта, а США только в последнюю очередь. Sticky id сессии держит один IP выхода между вызовами от 3 до 1440 минут, так что логин, корзина или постраничный список остаются на одной личности. Unlocker также помнит по доменам, какой уровень и какое семейство отпечатков недавно прошли, и начинает с них в следующий раз, а выход, который сайт только что отверг, отправляет в карантин вместо того, чтобы снова предлагать его этому сайту.

## Уровни Premium и Mobile, предоплата за ГБ

Web Unlocker работает на двух пулах выходов: Premium на резидентных IP и Mobile на IP операторов 4G/5G, у каждого свой предоплаченный баланс ГБ, который покупается в панели от 1 ГБ картой, PayPal, криптовалютой или балансом аккаунта. Использование измеряется в перемещённых байтах, включая повторы и рендеры браузера, а когда баланс кончается, ответом будет 402 со ссылкой на пополнение, а не тихий сбой. Цена за ГБ каждого уровня показана на странице Web Unlocker в панели рядом с кнопкой покупки. Без подписки и без минимального срока.

## Один каталог ошибок с тем, что делать дальше

REST и прокси делят один каталог. Каждая ошибка называет свой код и говорит, стоит ли повторять, была ли она оплачена и что делать дальше: no_credit (402) со ссылкой на покупку, target_blocked (424) с классом блокировки и журналом попыток, rate_limited (429, 20 вызовов в минуту и 10 одновременных на pay-as-you-go, с Retry-After), render_failed и upstream_failed (503), timeout (504), когда timeout_ms исчерпан. 403 или 429 с настоящей страницей — не блокировка и возвращается как есть.

## Часто задаваемые вопросы

### Что такое web unlocker?

Web unlocker — это сервис, который доставляет обычный HTTP-запрос на сайт под антибот-защитой так, как это сделал бы настоящий браузер: с резидентного IP, под TLS-отпечатком браузера с согласованными заголовками, повторяя на свежем IP при отказе и открывая настоящий браузер для JavaScript-вызовов. Он возвращает сырой ответ origin вместе с попытками и стоимостью.

### Чем web unlocker отличается от резидентного прокси?

Прокси меняет только исходный IP. TLS-рукопожатие и набор заголовков вашего клиента по-прежнему выдают автоматизированный инструмент, и именно это оценивают современные антибот-стены. Unlocker переписывает запрос под браузер, повторяет под другим отпечатком при отказе и переходит к настоящему браузеру, когда требуется JavaScript. Резидентные прокси — правильная покупка, когда ваш клиент уже проходит.

### Решает ли Web Unlocker капчи?

Он отвечает на JavaScript-вызовы настоящим браузером и в sticky-сессии сохраняет cookie clearance для следующих запросов к этому сайту. Интерактивные капчи, требующие человека, такие как hCaptcha, reCAPTCHA или поле для клика, не решаются: ответ возвращается с меткой captcha и названным поставщиком, а перемещённый трафик оплачивается за ГБ, если панель не указывает иное.

### Есть ли бесплатный пробный период Web Unlocker?

Создание аккаунта бесплатно и занимает минуту, а на странице Web Unlocker в панели есть поле Test a URL, показывающее статус, попытки, время и стоимость вызова. ГБ unlocker предоплачиваются по уровням от 1 ГБ, а стоимость первых тестовых вызовов написана рядом с полем. Бесплатный резидентный пробный период относится к обычным резидентным прокси, а не к unlocker.

### Можно ли вызывать его из Python, Node.js, PHP, Go или curl?

Да. REST-эндпоинт — обычный HTTPS POST, который умеет любой язык; вкладки выше содержат те же сниппеты curl, Python, Node.js, PHP и Go, которые панель заполняет вашими данными. Scrapy, Playwright или любой клиент с настройкой прокси используют CONNECT-прокси, а прямой режим работает там, где сертификат установить нельзя.

### Web Unlocker — это прокси или API?

И то и другое, на одном аккаунте и одном балансе. REST, когда вы можете менять код: JSON на входе, JSON на выходе, без сертификата. Прокси, когда ваш скрапер уже говорит по-прокси: хост, порт, пользователь и пароль, с CA, установленным один раз. Прямой режим, когда нужен прокси без сертификата: отправьте запрос на http://unlock/ и укажите цель в x-qp-url.

### Что происходит, если страница остаётся заблокированной после всех попыток, и плачу ли я за это?

Она никогда не возвращается как тихий успех. REST-эндпоинт ставит blocked в true и называет класс блокировки и поставщика рядом со страницей либо отвечает 424 target_blocked, если задан fail_on_block; прокси передаёт статус origin с x-qp-unlocker-blocked. Перемещённые байты оплачиваются за ГБ, если панель не указывает иное, а журнал попыток показывает, на что они ушли.

### Можно ли сохранить один IP на несколько запросов?

Да. Передайте id сессии в теле запроса или в имени пользователя прокси, и каждый вызов с этим id уходит с того же IP выхода от 3 до 1440 минут. Так логин, корзина или постраничный список остаются на одной личности, а не меняют IP на каждой странице.

### Из каких стран можно выходить?

Передайте country, а также state или city там, где они есть у сети, и уровень Premium выходит из этого рынка на резидентных IP; уровень Mobile делает то же на IP операторов 4G/5G. Оставьте пустым, и выход выбирается по домену верхнего уровня цели, затем по стране вашего аккаунта, США в последнюю очередь.

### Нужно ли устанавливать сертификат?

Только для HTTPS через CONNECT-прокси, который терминирует TLS, чтобы переписать запрос: скачайте CA один раз из API со своим ключом. Прямой режим, где цель идёт в заголовке x-qp-url, и REST-эндпоинт сертификата не требуют вовсе.

### Может ли он кликнуть, ввести текст или прокрутить страницу до её получения?

Да, в REST-вызове. Добавьте список действий браузера (клик, ввод текста, прокрутка, ожидание), и браузер выполнит их по порядку до получения страницы.

### Можно ли отправить много URL сразу?

Да. Пакет принимает до 100 URL в одном вызове, а вебхук сообщает, когда они завершились.

### Плачу ли я снова, если дважды запрашиваю одну и ту же страницу?

Нет, пока страница в кэше. Срок жизни кэша вы выбираете в вызове: пока он не истёк, та же страница отдаётся из кэша и ничего не стоит.

### Сколько стоит Web Unlocker?

Он оплачивается за перемещённый ГБ с предоплаченного баланса, который вы покупаете в панели для используемого уровня, Premium на резидентных выходах или Mobile на выходах операторов, от 1 ГБ. Повторы и рендеры браузера учитываются. Актуальная цена за ГБ показана на странице Web Unlocker в панели до покупки; без подписки и без минимального срока.

## Связанные продукты

- [Резидентный Web Unlocker](https://quantumproxies.io/web-unlocker/residential)
- [Мобильный Web Unlocker на IP 4G/5G](https://quantumproxies.io/web-unlocker/mobile)
- [Статус Web Unlocker и измеренная доля успешных вызовов](https://quantumproxies.io/web-unlocker/status)
- [Web Unlocker для Cloudflare](https://quantumproxies.io/web-unlocker/cloudflare)
- [Web Unlocker для DataDome](https://quantumproxies.io/web-unlocker/datadome)
- [Web Unlocker для Akamai Bot Manager](https://quantumproxies.io/web-unlocker/akamai)
- [Web Unlocker для PerimeterX (HUMAN)](https://quantumproxies.io/web-unlocker/perimeterx)
- [Web Unlocker для Kasada](https://quantumproxies.io/web-unlocker/kasada)
- [Web Unlocker для Imperva (Incapsula)](https://quantumproxies.io/web-unlocker/imperva)
- [Web Unlocker для F5 (BIG-IP, Shape)](https://quantumproxies.io/web-unlocker/f5)
- [Web Unlocker для AWS WAF](https://quantumproxies.io/web-unlocker/aws-waf)
- [Extract API: любая страница в Markdown, HTML или JSON](https://quantumproxies.io/ru/extract-api)
- [SERP API: результаты поиска в структурированном JSON](https://quantumproxies.io/ru/serp-api)
- [Прокси Residential Premium](https://quantumproxies.io/ru/residential-proxies)
- [Мобильные прокси на IP операторов 4G/5G](https://quantumproxies.io/ru/mobile-proxies)
- [Справочник REST API](https://quantumproxies.io/ru/api)
- [MCP-сервер для ИИ-агентов](https://quantumproxies.io/ru/mcp-server)

## Sources

- [RFC 9110: HTTP Semantics — safe and idempotent methods](https://www.rfc-editor.org/rfc/rfc9110.html#name-safe-methods)
- [RFC 9110: The CONNECT method](https://www.rfc-editor.org/rfc/rfc9110.html#name-connect)
- [RFC 8446: The Transport Layer Security (TLS) Protocol Version 1.3](https://www.rfc-editor.org/rfc/rfc8446.html)
- [Proxy-Authorization header (MDN Web Docs)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Proxy-Authorization)
- [JA3: a method for profiling SSL/TLS clients (Salesforce, GitHub)](https://github.com/salesforce/ja3)