# Web Unlocker API — z 403 do 200 | QuantumProxies.io Web Unlocker API i proxy: IP rezydencjalne, fingerprint TLS prawdziwej przeglądarki, nowe wyjście przy każdej odmowie i przeglądarka do wyzwań JavaScript. ## Web Unlocker API dla stron, które odrzucają Twój scraper Ty wysyłasz URL, my przynosimy stronę, która odpowiedziała 403: IP rezydencjalne, fingerprint TLS prawdziwej przeglądarki, nowe wyjście przy każdej odmowie i prawdziwa przeglądarka, gdy strona wymaga JavaScriptu. Odpowiedź niesie status, próby, czas i koszt, więc zawsze wiesz, co się stało. - **88.9%** wywołań zwróciło prawdziwą stronę - **4.1 s** mediana czasu do strony (p50) - **27** celów chronionych anti-botem, po 3 przebiegi każdy Zmierzone 2026-11-11 przez nasz własny canary: 72 z 81 wywołań. Strony demo z captchą są uruchamiane, ale nie liczone, bo interaktywne captche nie są rozwiązywane. ![Web Unlocker QuantumProxies: jeden POST do /api/v1/scraper/unlock z adresem URL i krajem, żądanie wysłane ponownie z IP rezydencjalnego pod fingerprintem TLS przeglądarki z prawdziwą przeglądarką w gotowości, a strona, która odpowiedziała 403, wraca jako 200 OK ze statusem, flagą blocked, zwycięskim poziomem i dziennikiem prób.](https://quantumproxies.io/images/web-unlocker/web-unlocker-403-to-200.webp?v=20261104) ## Z 403 do 200, zmierzone ### Co dostaje Twój klient **403** 403, kontrolę bezpieczeństwa albo wyzwanie JavaScript zamiast strony, choćby IP było czyste i jakikolwiek User-Agent byś ustawił. ### Co zwrócił Web Unlocker 2026-11-11 **200** 88.9% z 81 wywołań do 27 chronionych celów wróciło jako prawdziwa strona: mediana 4.1 s, p95 28.8 s. Nasz własny canary, nie liczba z broszury: te same cele, po 3 przebiegi każdy. Przebieg jest powtarzany, a każda liczba na tej stronie jest generowana na nowo z jego pliku. ### Skuteczność według systemu anti-bot Wygenerowane z przebiegu canary z 2026-11-11, 3 przebiegi na tych samych celach. Strony z interaktywną captchą są wyłączone. | System anti-bot | Skuteczność | Mediana czasu | Wywołania | | --- | --- | --- | --- | | 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 | ### Jak mierzymy Te liczby pochodzą z naszego własnego canary, przebiegu powtarzanego na tych samych stronach. Ruch klientów nigdy nie jest jego częścią. - Stała lista chronionych stron, pogrupowanych według systemu ochrony. - Liczba przebiegów po całej liście: 3. - Wywołanie jest sukcesem tylko wtedy, gdy zwraca prawdziwą stronę ze statusem 200. - Strony z wyzwaniem, puste odpowiedzi i timeouty liczą się jako porażki. - Strony demo z captchą też są uruchamiane, ale nie wchodzą do wyniku. **Ostatni przebieg: 2026-11-11. Strony: 27, przebiegi na stronę: 3, wywołania: 81, prawdziwe strony: 72 (88.9%).** - [Pobierz plik danych tego przebiegu (JSON)](https://quantumproxies.io/data/unlocker-canary.json) - [Strona statusu na żywo](https://quantumproxies.io/web-unlocker/status) ## Którego produktu potrzebujesz Trzy produkty dzielą tę samą sieć rezydencjalną. Który wywołać, zależy od tego, co cel robi z Twoim żądaniem. ### Web Unlocker Strona odrzuca Twojego klienta kodem 403, kontrolą bezpieczeństwa albo wyzwaniem: jedno wywołanie przynosi prawdziwą odpowiedź, dowolną metodą, z Twoimi nagłówkami i body, z logowaniem lub koszykiem trzymanymi na jednym wyjściu, rozliczane za GB z przedpłaconego salda. ### [Proxy rezydencjalne](https://quantumproxies.io/pl/residential-proxies) Twój klient już przechodzi i potrzebujesz tylko innego IP: wyjście rezydencjalne z tą samą gramatyką nazwy użytkownika (kraj, stan, miasto, sesja) przez HTTP lub SOCKS5. ### [Extract API](https://quantumproxies.io/pl/extract-api) Chcesz stronę jako Markdown, tekst lub JSON i nie potrzebujesz surowej odpowiedzi, POST-a ani własnego cookie jar. ## Który endpoint Ten sam silnik za trzema drzwiami. Wybierz według tego, czym już mówi Twój kod; snippety to te, które panel wypełnia Twoimi własnymi danymi. ### REST API Możesz zmienić swój kod: jedno wywołanie JSON na wejściu, jedna odpowiedź JSON na wyjściu, żadnego certyfikatu do instalacji. `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"}' ``` ### Proxy (CONNECT) Masz już scraper, który mówi proxy: skieruj go na host i port z użytkownikiem i hasłem unlockera i zainstaluj CA raz. `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/ ``` ### Tryb bezpośredni Proxy bez certyfikatu: wyślij żądanie do http://unlock/ przez proxy i wskaż cel w nagłówku 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/ ``` ## Akcje przeglądarki, paczki, cache i gotowe klienty ### Akcje przeglądarki przed przechwyceniem W wywołaniu REST możesz wypisać, co przeglądarka robi przed przechwyceniem strony: kliknięcie, wpisanie tekstu, przewinięcie, czekanie. ### Paczki do 100 adresów URL Wyślij do 100 adresów URL w jednej paczce i odbierz webhook, gdy się zakończą. ### Cache z czasem życia, który wybierasz Sam ustawiasz, jak długo strona zostaje w cache. Dopóki tam jest, ponowne żądanie tej samej strony nic nie kosztuje. ### Dwa klienty do pobrania i tabela migracji W dokumentacji są dwa jednoplikowe klienty, jeden dla Node.js i jeden dla Pythona, oraz tabela migracji dla kodu napisanego pod inny unlocker. [Otwórz dokumentację Web Unlockera](https://quantumproxies.io/docs/#tag/Web-Unlocker) ## Wideo: Web Unlocker w panelu Przegląd strony Web Unlocker w panelu: kup GB, wybierz sposób połączenia i wyślij pierwsze żądanie. Po angielsku, z napisami. ## Jak działa Web Unlocker ### 1 · Twoje żądanie wychodzi jak przeglądarka Nagłówki tożsamości wysyłane przez Twojego klienta (User-Agent, Accept, Sec-Fetch-*) są zastępowane zestawem zgodnym z uściskiem dłoni TLS prawdziwej przeglądarki. Authorization, cookies, content type i własne nagłówki przechodzą nietknięte. ### 2 · Odmowa ponawia próbę na świeżym wyjściu rezydencjalnym Wyzwanie lub 403 uruchamia ponowną próbę na nowym wyjściu pod inną rodziną fingerprintów, do trzech prób TLS, wszystkie w jednym budżecie czasu: domyślnie 60 sekund, do 120 z timeout_ms. ### 3 · Nadal zablokowane? Przejmuje prawdziwa przeglądarka Gdy poziom TLS wciąż dostaje wyzwania, prawdziwa przeglądarka otwiera stronę i odpowiada na wyzwanie JavaScript. Ze sticky sesją uzyskany clearance jest zachowywany i odtwarzany przy Twoich kolejnych żądaniach do tej strony. Web Unlocker API jest dla stron, których zwykły klient HTTP nie dostanie: tych, gdzie warstwa anti-bot ocenia uścisk dłoni TLS i ustawienia HTTP/2, zanim przeczyta choć jeden nagłówek. Wywołanie fetch lub requests niesie sygnaturę swojego środowiska, jakikolwiek User-Agent by ustawiło. Unlocker naprawia to w warstwie transportowej, ponawia próbę na świeżym wyjściu rezydencjalnym, gdy origin odmawia, otwiera prawdziwą przeglądarkę, gdy wymagany jest JavaScript, i oddaje surową odpowiedź origin: dowolna metoda, Twoje nagłówki i body, logowanie lub koszyk trzymane na jednym IP wyjściowym. ## Co robi web unlocker, czego nie robi proxy Rotujące proxy rezydencjalne zmienia, skąd pochodzi żądanie. Nie zmienia tego, jak żądanie wygląda: uścisk dłoni TLS, kolejność ramek HTTP/2 i zestaw nagłówków nadal mówią Python albo Node, a nowoczesne zapory anti-bot oceniają dokładnie to. Web unlocker przepisuje żądanie na takie, jakie wysłałaby prawdziwa przeglądarka, ponawia próbę pod innym fingerprintem, gdy origin je odrzuca, i przełącza się na prawdziwą przeglądarkę, gdy origin wymaga JavaScriptu. Zachowujesz interfejs proxy; unlocker dodaje osąd. ## Fingerprinty TLS prawdziwych przeglądarek Każda próba wychodzi pod profilem TLS prawdziwej przeglądarki, z nagłówkami tożsamości przepisanymi tak, by do niego pasowały, bo uścisk dłoni Chrome niosący User-Agent Firefoksa jest głośniejszym sygnałem niż każdy z nich osobno. Przypnij profil (Chrome, Firefox, Safari, Safari iOS, Edge, Brave albo mobilne Safari na endpoincie REST), gdy strona go oczekuje; nie przypinaj żadnego, a ponowne próby rotują między Chrome, Firefoksem i Brave, więc strona, która spaliła jeden uścisk dłoni, spotyka inny. Authorization, Cookie, Content-Type i własne nagłówki X-* są przekazywane dosłownie, a keepHeaders wysyła Twoje bez zmian, gdy odtwarzasz przechwycone żądanie aplikacji. ## Tryby, formaty i budżet czasu mode auto, domyślny, wspina się po drabinie: najpierw poziom TLS, świeże wyjście przy odmowie, przeglądarka, gdy strona wciąż rzuca wyzwania. mode tls nigdy nie otwiera przeglądarki; mode browser zaczyna w niej. format zwraca body jako html, markdown lub text, a render png robi zrzut ekranu. Całe wywołanie, z ponownymi próbami i renderowaniem, mieści się w jednym budżecie domyślnie 60 sekund, do 120 z timeout_ms, a max_bytes ogranicza ruch, jaki jedno wywołanie może przenieść. Odpowiedź mówi, który poziom wygrał (tier_served), wylicza każdą próbę z poziomem, profilem, krajem wyjścia, wynikiem, milisekundami i bajtami (attempt_log) i podaje koszt w bajtach i dolarach po cenie Twojego poziomu. ## Blokada jest raportowana, nigdy przebrana za sukces Każda odpowiedź jest klasyfikowana, zanim do Ciebie dotrze. Klasyfikator czyta to, czym systemy obrony przed botami podpisują swoje strony, i nazywa zarówno system (Cloudflare, DataDome, Akamai, PerimeterX i inne), jak i klasę blokady: js_challenge, captcha, access_denied, rate_limited, fingerprint, geo lub timeout. Na endpoincie REST nadal zablokowana strona przychodzi jako 200 z blocked ustawionym na true i samą stroną do wglądu, albo jako 424 target_blocked, gdy ustawisz fail_on_block. Na forward proxy status origin jest przekazywany z nagłówkiem x-qp-unlocker-blocked. Interaktywne captche nie są rozwiązywane: wracają oznaczone jako captcha. ## Sesje, targetowanie geograficzne i pamięć per strona Podaj kraj, a także stan lub miasto tam, gdzie sieć je ma, by wychodzić z tego rynku. Zostaw puste, a kraj wyjścia jest czytany z domeny najwyższego poziomu celu, potem z kraju Twojego konta, a Stany Zjednoczone tylko w ostateczności. Sticky id sesji trzyma jedno IP wyjściowe między wywołaniami przez 3 do 1440 minut, więc logowanie, koszyk lub stronicowana lista zostają na jednej tożsamości. Unlocker pamięta też per domena, który poziom i która rodzina fingerprintów ostatnio przeszły, i zaczyna od nich następnym razem, a wyjście, które strona właśnie odrzuciła, odkłada na kwarantannę zamiast proponować je tej stronie ponownie. ## Poziomy Premium i Mobile, przedpłacone za GB Web Unlocker działa na dwóch pulach wyjść: Premium na IP rezydencjalnych i Mobile na IP operatorów 4G/5G, każda z własnym przedpłaconym saldem GB kupowanym w panelu od 1 GB, kartą, PayPalem, kryptowalutą lub saldem konta. Zużycie mierzy się w przeniesionych bajtach, z ponownymi próbami i renderami przeglądarki, a gdy saldo się skończy, odpowiedzią jest 402 z linkiem do doładowania zamiast cichej porażki. Cena za GB każdego poziomu jest pokazana na stronie Web Unlocker w panelu, obok przycisku zakupu. Bez abonamentu, bez minimalnego okresu. ## Jeden katalog błędów, z tym, co robić dalej REST i proxy dzielą jeden katalog. Każdy błąd podaje swój kod i mówi, czy warto ponowić, czy został rozliczony i co robić dalej: no_credit (402) z linkiem do zakupu, target_blocked (424) z klasą blokady i dziennikiem prób, rate_limited (429, 20 wywołań na minutę i 10 równoczesnych w pay-as-you-go, z Retry-After), render_failed i upstream_failed (503), timeout (504), gdy timeout_ms się wyczerpał. 403 lub 429 niosące prawdziwą stronę nie jest blokadą i jest zwracane jako takie. ## Najczęściej zadawane pytania ### Czym jest web unlocker? Web unlocker to usługa, która dostarcza zwykłe żądanie HTTP do strony chronionej anti-botem tak, jak zrobiłaby to prawdziwa przeglądarka: z IP rezydencjalnego, pod fingerprintem TLS przeglądarki z pasującymi nagłówkami, ponawiając na świeżym IP przy odmowie i otwierając prawdziwą przeglądarkę do wyzwań JavaScript. Zwraca surową odpowiedź origin, z próbami i kosztem. ### Czym web unlocker różni się od proxy rezydencjalnego? Proxy zmienia tylko IP źródłowe. Uścisk dłoni TLS i zestaw nagłówków Twojego klienta nadal zdradzają zautomatyzowane narzędzie, a to właśnie oceniają nowoczesne zapory anti-bot. Unlocker przepisuje żądanie na przeglądarkowe, ponawia pod innym fingerprintem przy odmowie i eskaluje do prawdziwej przeglądarki, gdy wymagany jest JavaScript. Proxy rezydencjalne to właściwy zakup, gdy Twój klient już przechodzi. ### Czy Web Unlocker rozwiązuje CAPTCHE? Odpowiada na wyzwania JavaScript prawdziwą przeglądarką i w sticky sesji zachowuje cookie clearance na kolejne żądania do tej strony. Interaktywne captche wymagające człowieka, jak hCaptcha, reCAPTCHA czy pole do kliknięcia, nie są rozwiązywane: odpowiedź wraca oznaczona jako captcha, z nazwanym dostawcą, a przeniesiony ruch jest rozliczany za GB, chyba że panel stanowi inaczej. ### Czy jest darmowy okres próbny Web Unlockera? Założenie konta jest darmowe i zajmuje minutę, a strona Web Unlocker w panelu ma pole Test a URL, które pokazuje status, próby, czas i koszt wywołania. GB unlockera są przedpłacane per poziom od 1 GB, a koszt pierwszych wywołań testowych jest wypisany obok pola. Darmowy okres próbny rezydencjalny obejmuje zwykłe proxy rezydencjalne, nie unlocker. ### Czy mogę wywołać go z Pythona, Node.js, PHP, Go lub curl? Tak. Endpoint REST to zwykły POST HTTPS, którym mówi każdy język; zakładki powyżej zawierają te same snippety curl, Python, Node.js, PHP i Go, które panel wypełnia Twoimi danymi. Scrapy, Playwright lub dowolny klient z ustawieniem proxy używa proxy CONNECT, a tryb bezpośredni działa tam, gdzie nie da się zainstalować certyfikatu. ### Czy Web Unlocker to proxy czy API? Jedno i drugie, na jednym koncie i jednym saldzie. REST, gdy możesz zmienić kod: JSON na wejściu, JSON na wyjściu, bez certyfikatu. Proxy, gdy Twój scraper już mówi proxy: host, port, użytkownik i hasło, z CA zainstalowanym raz. Tryb bezpośredni, gdy chcesz proxy bez certyfikatu: wyślij żądanie do http://unlock/ i wskaż cel w x-qp-url. ### Co się dzieje, gdy strona pozostaje zablokowana po każdej próbie, i czy za to płacę? Nigdy nie jest zwracana jako cichy sukces. Endpoint REST ustawia blocked na true i podaje klasę blokady oraz dostawcę obok strony, albo odpowiada 424 target_blocked, gdy ustawisz fail_on_block; proxy przekazuje status origin z x-qp-unlocker-blocked. Przeniesione bajty są rozliczane za GB, chyba że panel stanowi inaczej, a dziennik prób pokazuje, co za nie kupiono. ### Czy mogę zachować to samo IP przez kilka żądań? Tak. Podaj id sesji, w body żądania lub w nazwie użytkownika proxy, a każde wywołanie z tym id wychodzi z tego samego IP przez 3 do 1440 minut. Tak logowanie, koszyk lub stronicowana lista zostają na jednej tożsamości zamiast zmieniać IP na każdej stronie. ### Z jakich krajów mogę wychodzić? Podaj country, a także state lub city tam, gdzie sieć je ma, a poziom Premium wychodzi z tego rynku na IP rezydencjalnych; poziom Mobile robi to samo na IP operatorów 4G/5G. Zostaw puste, a wyjście jest wybierane według domeny najwyższego poziomu celu, potem kraju Twojego konta, ze Stanami Zjednoczonymi w ostateczności. ### Czy muszę instalować certyfikat? Tylko dla HTTPS przez proxy CONNECT, które kończy TLS, by przepisać żądanie: pobierz CA raz z API swoim kluczem. Tryb bezpośredni, gdzie cel trafia do nagłówka x-qp-url, i endpoint REST nie wymagają żadnego certyfikatu. ### Czy może kliknąć, wpisać tekst lub przewinąć stronę przed jej przechwyceniem? Tak, w wywołaniu REST. Dodaj listę akcji przeglądarki (kliknięcie, wpisanie tekstu, przewinięcie, czekanie), a przeglądarka wykona je po kolei przed przechwyceniem strony. ### Czy mogę wysłać wiele adresów URL naraz? Tak. Paczka przyjmuje do 100 adresów URL w jednym wywołaniu, a webhook informuje, gdy się zakończą. ### Czy płacę ponownie, gdy dwa razy proszę o tę samą stronę? Nie, dopóki strona jest w cache. Czas życia cache wybierasz w wywołaniu: dopóki nie minie, ta sama strona jest zwracana z cache i nic nie kosztuje. ### Ile kosztuje Web Unlocker? Jest rozliczany za przeniesiony GB, z przedpłaconego salda, które kupujesz w panelu dla używanego poziomu, Premium na wyjściach rezydencjalnych lub Mobile na wyjściach operatorów, od 1 GB. Ponowne próby i rendery przeglądarki się liczą. Aktualna cena za GB jest pokazana na stronie Web Unlocker w panelu przed zakupem; bez abonamentu, bez minimalnego okresu. ## Powiązane produkty - [Web Unlocker rezydencjalny](https://quantumproxies.io/web-unlocker/residential) - [Mobilny Web Unlocker na IP 4G/5G](https://quantumproxies.io/web-unlocker/mobile) - [Status Web Unlockera i zmierzona skuteczność](https://quantumproxies.io/web-unlocker/status) - [Web Unlocker dla Cloudflare](https://quantumproxies.io/web-unlocker/cloudflare) - [Web Unlocker dla DataDome](https://quantumproxies.io/web-unlocker/datadome) - [Web Unlocker dla Akamai Bot Manager](https://quantumproxies.io/web-unlocker/akamai) - [Web Unlocker dla PerimeterX (HUMAN)](https://quantumproxies.io/web-unlocker/perimeterx) - [Web Unlocker dla Kasada](https://quantumproxies.io/web-unlocker/kasada) - [Web Unlocker dla Imperva (Incapsula)](https://quantumproxies.io/web-unlocker/imperva) - [Web Unlocker dla F5 (BIG-IP, Shape)](https://quantumproxies.io/web-unlocker/f5) - [Web Unlocker dla AWS WAF](https://quantumproxies.io/web-unlocker/aws-waf) - [Extract API: dowolna strona jako Markdown, HTML lub JSON](https://quantumproxies.io/pl/extract-api) - [SERP API: wyniki wyszukiwania jako ustrukturyzowany JSON](https://quantumproxies.io/pl/serp-api) - [Proxy Residential Premium](https://quantumproxies.io/pl/residential-proxies) - [Proxy mobilne na IP operatorów 4G/5G](https://quantumproxies.io/pl/mobile-proxies) - [Dokumentacja API REST](https://quantumproxies.io/pl/api) - [Serwer MCP dla agentów AI](https://quantumproxies.io/pl/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)