feat: unblocker proxy docs

sources/platform/proxy/index.md

@@ -36,6 +36,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="/proxy/google-serp-proxy"
     />
+    <Card
+        title="Unblocker proxy"
+        desc="Automatically bypasses anti-bot and anti-captcha systems using built-in smart routing, so you don't need to detect or solve challenges yourself."
+        to="/proxy/unblocker-proxy"
+    />
 </CardGrid>
 
 ## Quickstart
@@ -97,6 +102,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)
@@ -191,6 +197,7 @@ The table below describes the available parameters.
             <br/>- <code>groups-[group name]</code> or <code>auto</code> when using datacenter proxies.
             <br/>- <code>groups-RESIDENTIAL</code> when using residential proxies.
             <br/>- <code>groups-GOOGLE_SERP</code> when using Google SERP proxies.
+            <br/>- <code>groups-UNBLOCKER</code> when using [Unblocker proxy](./unblocker_proxy.md).
         </td>
     </tr>
     <tr>

sources/platform/proxy/unblocker_proxy.md

@@ -0,0 +1,123 @@
+---
+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 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.
+
+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 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
+
+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:
+
+```js
+const proxyUrl = 'http://groups-UNBLOCKER:<YOUR_PROXY_PASSWORD>@proxy.apify.com:8000';
+```
+
+In the [Apify SDK](/sdk) you set `groups` in your proxy configuration:
+
+<Tabs groupId="main">
+<TabItem value="JavaScript" label="JavaScript">
+
+```js
+import { Actor } from 'apify';
+
+await Actor.init();
+// ...
+const proxyConfiguration = await Actor.createProxyConfiguration({
+    groups: ['UNBLOCKER'],
+});
+// ...
+await Actor.exit();
+```
+
+</TabItem>
+<TabItem value="Python" label="Python">
+
+```python
+from apify import Actor
+
+async def main():
+    async with Actor:
+        # ...
+        proxy_configuration = await Actor.create_proxy_configuration(groups=['UNBLOCKER'])
+        # ...
+```
+
+</TabItem>
+</Tabs>
+
+### 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):
+
+<Tabs groupId="main">
+<TabItem value="JavaScript" label="JavaScript">
+
+```js
+import { Actor } from 'apify';
+
+await Actor.init();
+// ...
+const proxyConfiguration = await Actor.createProxyConfiguration({
+    groups: ['UNBLOCKER'],
+    countryCode: 'FR',
+});
+// ...
+await Actor.exit();
+```
+
+</TabItem>
+<TabItem value="Python" label="Python">
+
+```python
+from apify import Actor
+
+async def main():
+    async with Actor:
+        # ...
+        proxy_configuration = await Actor.create_proxy_configuration(
+            groups=['UNBLOCKER'],
+            country_code='FR',
+        )
+        # ...
+```
+
+</TabItem>
+</Tabs>
+
+## 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)

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
 ---