From 17cbe55e4a48509b8a77c37aa933bac917d556b3 Mon Sep 17 00:00:00 2001 From: Daniil Poletaev Date: Wed, 1 Jul 2026 12:02:19 +0200 Subject: [PATCH 1/5] feat: unblocker proxy docs --- sources/platform/proxy/index.md | 7 ++ sources/platform/proxy/unblocker_proxy.md | 120 ++++++++++++++++++++++ 2 files changed, 127 insertions(+) create mode 100644 sources/platform/proxy/unblocker_proxy.md diff --git a/sources/platform/proxy/index.md b/sources/platform/proxy/index.md index 4c01e0ceb1..bc060e317b 100644 --- a/sources/platform/proxy/index.md +++ b/sources/platform/proxy/index.md @@ -35,6 +35,11 @@ Each proxy type has distinct advantages, disadvantages, and pricing. Use them to desc="Download and extract data from Google Search Engine Result Pages (SERPs). You can select country and language to get localized results." to="/platform/proxy/google-serp-proxy" /> + ## Quickstart @@ -96,6 +101,7 @@ For more examples connecting to Apify Proxy from the SDKs and other libraries: * [Datacenter proxy](./datacenter_proxy.md#examples) * [Residential proxy](./residential_proxy.md#connecting-to-residential-proxy) * [Google SERP proxy](./google_serp_proxy.md#examples) +* [Unblocker proxy](./unblocker_proxy.md#connect-to-unblocker-proxy) * [Apify SDK JavaScript](/sdk/js/docs/guides/proxy-management) * [Apify SDK Python](/sdk/python/docs/concepts/proxy-management) * [Crawlee](https://crawlee.dev/docs/guides/proxy-management) @@ -190,6 +196,7 @@ The table below describes the available parameters.
- groups-[group name] or auto when using datacenter proxies.
- groups-RESIDENTIAL when using residential proxies.
- groups-GOOGLE_SERP when using Google SERP proxies. +
- groups-UNBLOCKER when using Unblocker proxy. diff --git a/sources/platform/proxy/unblocker_proxy.md b/sources/platform/proxy/unblocker_proxy.md new file mode 100644 index 0000000000..d292ac413d --- /dev/null +++ b/sources/platform/proxy/unblocker_proxy.md @@ -0,0 +1,120 @@ +--- +title: Unblocker proxy +description: Bypass anti-bot and anti-captcha systems automatically when scraping, without building or maintaining your own bypass logic for blocked websites. +sidebar_position: 10.5 +slug: /proxy/unblocker-proxy +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + +Unblocker proxy bypasses anti-bot and anti-captcha systems automatically, so you don't need to figure out how to get through them yourself. + +Use Unblocker proxy when a website blocks scrapers with anti-bot protection or captchas, and you want the proxy to handle bypassing them for you instead of building and maintaining your own bypass logic. + +## Pricing + +Unblocker proxy uses unit-based pricing. Each request through Unblocker proxy is currently billed at 10 units. + +## Connect to Unblocker proxy + +Connecting to Unblocker proxy works the same way as [datacenter proxy](./datacenter_proxy.md), with one difference: the `groups` [username parameter](./index.md#username-parameters) should always specify `UNBLOCKER`. + +### How to set a proxy group + +When using [standard libraries and languages](./datacenter_proxy.md), specify the `groups` parameter in the [username](./index.md#username-parameters) as `groups-UNBLOCKER`. + +For example, your **proxy URL** when using the [got-scraping](https://www.npmjs.com/package/got-scraping) JavaScript library will look like this: + +```js +const proxyUrl = 'http://groups-UNBLOCKER:@proxy.apify.com:8000'; +``` + +In the [Apify SDK](/sdk) you set the **groups** in your proxy configuration: + + + + +```js +import { Actor } from 'apify'; + +await Actor.init(); +// ... +const proxyConfiguration = await Actor.createProxyConfiguration({ + groups: ['UNBLOCKER'], +}); +// ... +await Actor.exit(); +``` + + + + +```python +from apify import Actor + +async def main(): + async with Actor: + # ... + proxy_configuration = await Actor.create_proxy_configuration(groups=['UNBLOCKER']) + # ... +``` + + + + +### How to set a proxy country + +Unblocker proxy selects the best available country automatically based on the target website. You don't need to set a country in most cases. + +If you need requests to come from a specific country, specify the `country` [username parameter](./index.md#username-parameters) as `country-COUNTRY-CODE`. For example, to target Japan, set the username to `groups-UNBLOCKER,country-JP`. + +:::tip Let Unblocker proxy decide + +Only set a country when your use case requires it (for example, geo-restricted content). Setting a country limits the pool of available IP addresses and can reduce how effectively Unblocker proxy bypasses anti-bot protection. + +::: + +In the [Apify SDK](/sdk) you set the country in your proxy configuration using two-letter [country codes](https://laendercode.net/en/2-letter-list.html): + + + + +```js +import { Actor } from 'apify'; + +await Actor.init(); +// ... +const proxyConfiguration = await Actor.createProxyConfiguration({ + groups: ['UNBLOCKER'], + countryCode: 'FR', +}); +// ... +await Actor.exit(); +``` + + + + +```python +from apify import Actor + +async def main(): + async with Actor: + # ... + proxy_configuration = await Actor.create_proxy_configuration( + groups=['UNBLOCKER'], + country_code='FR', + ) + # ... +``` + + + + +## Related features + +- [Datacenter proxy](./datacenter_proxy.md) +- [Residential proxy](./residential_proxy.md) +- [Google SERP proxy](./google_serp_proxy.md) +- [Anti-scraping techniques](/academy/anti-scraping/techniques) From 2a23c60a49d6ac77805af35349be9dd93157079a Mon Sep 17 00:00:00 2001 From: Daniil Poletaev Date: Wed, 1 Jul 2026 13:14:53 +0200 Subject: [PATCH 2/5] refactor: clean up --- sources/platform/proxy/unblocker_proxy.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/sources/platform/proxy/unblocker_proxy.md b/sources/platform/proxy/unblocker_proxy.md index d292ac413d..6e3eb42ffb 100644 --- a/sources/platform/proxy/unblocker_proxy.md +++ b/sources/platform/proxy/unblocker_proxy.md @@ -8,13 +8,11 @@ slug: /proxy/unblocker-proxy import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -Unblocker proxy bypasses anti-bot and anti-captcha systems automatically, so you don't need to figure out how to get through them yourself. +Unblocker proxy is designed for scraping websites protected by anti-bot and anti-captcha systems. Instead of building and maintaining your own detection and bypass logic, you can route requests through Unblocker proxy, which automatically handles many common protection mechanisms. -Use Unblocker proxy when a website blocks scrapers with anti-bot protection or captchas, and you want the proxy to handle bypassing them for you instead of building and maintaining your own bypass logic. +This makes it a good choice for accessing websites with advanced bot protection while keeping your scraping code simple. -## Pricing - -Unblocker proxy uses unit-based pricing. Each request through Unblocker proxy is currently billed at 10 units. +**Pricing is based on units.** Each request through Unblocker proxy is currently billed at 10 units. ## Connect to Unblocker proxy From 2a32665d712812457c5f589b7eeb60076d377bea Mon Sep 17 00:00:00 2001 From: Daniil Poletaev Date: Tue, 18 Aug 2026 09:56:18 +0200 Subject: [PATCH 3/5] refactor: clean up --- sources/platform/proxy/index.md | 4 ++-- sources/platform/proxy/unblocker_proxy.md | 13 +++++++++---- sources/platform/proxy/your_own_proxies.md | 2 +- 3 files changed, 12 insertions(+), 7 deletions(-) diff --git a/sources/platform/proxy/index.md b/sources/platform/proxy/index.md index da029892bd..2f1705f41b 100644 --- a/sources/platform/proxy/index.md +++ b/sources/platform/proxy/index.md @@ -39,7 +39,7 @@ Each proxy type has distinct advantages, disadvantages, and pricing. Use them to @@ -197,7 +197,7 @@ The table below describes the available parameters.
- groups-[group name] or auto when using datacenter proxies.
- groups-RESIDENTIAL when using residential proxies.
- groups-GOOGLE_SERP when using Google SERP proxies. -
- groups-UNBLOCKER when using Unblocker proxy. +
- groups-UNBLOCKER when using [Unblocker proxy](./unblocker_proxy.md). diff --git a/sources/platform/proxy/unblocker_proxy.md b/sources/platform/proxy/unblocker_proxy.md index 6e3eb42ffb..bd02315167 100644 --- a/sources/platform/proxy/unblocker_proxy.md +++ b/sources/platform/proxy/unblocker_proxy.md @@ -12,23 +12,28 @@ Unblocker proxy is designed for scraping websites protected by anti-bot and anti This makes it a good choice for accessing websites with advanced bot protection while keeping your scraping code simple. -**Pricing is based on units.** Each request through Unblocker proxy is currently billed at 10 units. +Unblocker proxy uses its own pricing unit, separate from [compute units](/actors/running/usage-and-resources#what-is-a-compute-unit). Pricing is per 1,000 units, and the rate depends on your subscription plan. Each request is billed 10 units. ## Connect to Unblocker proxy -Connecting to Unblocker proxy works the same way as [datacenter proxy](./datacenter_proxy.md), with one difference: the `groups` [username parameter](./index.md#username-parameters) should always specify `UNBLOCKER`. +Connecting to Unblocker proxy works the same way as [datacenter proxy](./datacenter_proxy.md), with two differences: + +- The `groups` [username parameter](./index.md#username-parameters) must always specify `UNBLOCKER`. +- Unblocker proxy selects the country automatically, so you rarely need to set `country`. + +Unlike [datacenter](./datacenter_proxy.md) or [residential](./residential_proxy.md) proxies, Unblocker proxy has no [session](./index.md#sessions) parameter, so you can't keep the same IP address across requests. ### How to set a proxy group When using [standard libraries and languages](./datacenter_proxy.md), specify the `groups` parameter in the [username](./index.md#username-parameters) as `groups-UNBLOCKER`. -For example, your **proxy URL** when using the [got-scraping](https://www.npmjs.com/package/got-scraping) JavaScript library will look like this: +For example, your proxy URL when using the [got-scraping](https://www.npmjs.com/package/got-scraping) JavaScript library will look like this: ```js const proxyUrl = 'http://groups-UNBLOCKER:@proxy.apify.com:8000'; ``` -In the [Apify SDK](/sdk) you set the **groups** in your proxy configuration: +In the [Apify SDK](/sdk) you set `groups` in your proxy configuration: diff --git a/sources/platform/proxy/your_own_proxies.md b/sources/platform/proxy/your_own_proxies.md index 5a448095e8..23ad76f40f 100644 --- a/sources/platform/proxy/your_own_proxies.md +++ b/sources/platform/proxy/your_own_proxies.md @@ -1,7 +1,7 @@ --- title: Using your own proxies description: Add your own proxy URLs to Actor runs in Apify Console or configure them in the Apify SDK using the proxy configuration API for JavaScript and Python. -sidebar_position: 10.5 +sidebar_position: 10.6 slug: /proxy/using-your-own-proxies --- From feccad7957b42fb9cf9c2536ee006a7206fc10ab Mon Sep 17 00:00:00 2001 From: Daniil Poletaev Date: Tue, 18 Aug 2026 10:33:21 +0200 Subject: [PATCH 4/5] chore: update sources/platform/proxy/unblocker_proxy.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com> --- sources/platform/proxy/unblocker_proxy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/proxy/unblocker_proxy.md b/sources/platform/proxy/unblocker_proxy.md index bd02315167..e0b47afeb6 100644 --- a/sources/platform/proxy/unblocker_proxy.md +++ b/sources/platform/proxy/unblocker_proxy.md @@ -12,7 +12,7 @@ Unblocker proxy is designed for scraping websites protected by anti-bot and anti This makes it a good choice for accessing websites with advanced bot protection while keeping your scraping code simple. -Unblocker proxy uses its own pricing unit, separate from [compute units](/actors/running/usage-and-resources#what-is-a-compute-unit). Pricing is per 1,000 units, and the rate depends on your subscription plan. Each request is billed 10 units. +Pricing is based on Unblocker units, which are separate from [compute units](/actors/running/usage-and-resources#what-is-a-compute-unit). Each request costs 10 units. Units are priced per 1,000 at a rate that depends on your plan, and your consumption is displayed on your [proxy usage dashboard](https://console.apify.com/proxy/usage) in Apify Console. ## Connect to Unblocker proxy From 0685ba5f0242bdf7aa55992255562516de0c9463 Mon Sep 17 00:00:00 2001 From: Daniil Poletaev Date: Tue, 18 Aug 2026 14:22:45 +0200 Subject: [PATCH 5/5] refactor: clean up --- sources/platform/proxy/unblocker_proxy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sources/platform/proxy/unblocker_proxy.md b/sources/platform/proxy/unblocker_proxy.md index e0b47afeb6..e2eb0a260c 100644 --- a/sources/platform/proxy/unblocker_proxy.md +++ b/sources/platform/proxy/unblocker_proxy.md @@ -12,7 +12,7 @@ Unblocker proxy is designed for scraping websites protected by anti-bot and anti This makes it a good choice for accessing websites with advanced bot protection while keeping your scraping code simple. -Pricing is based on Unblocker units, which are separate from [compute units](/actors/running/usage-and-resources#what-is-a-compute-unit). Each request costs 10 units. Units are priced per 1,000 at a rate that depends on your plan, and your consumption is displayed on your [proxy usage dashboard](https://console.apify.com/proxy/usage) in Apify Console. +Pricing is based on Unblocker units, which are separate from [compute units](/actors/running/usage-and-resources#what-is-a-compute-unit). Each successful request costs 10 units. Units are priced per 1,000 at a rate that depends on your plan, and your consumption is displayed on your [proxy usage dashboard](https://console.apify.com/proxy/usage) in Apify Console. ## Connect to Unblocker proxy