Skip to main content

Unblocker proxy

Copy for LLM

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. 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 in Apify Console.

Connect to Unblocker proxy

Connecting to Unblocker proxy works the same way as datacenter proxy, with two differences:

  • The groups username parameter must always specify UNBLOCKER.
  • Unblocker proxy selects the country automatically, so you rarely need to set country.

Unlike datacenter or residential proxies, Unblocker proxy has no session parameter, so you can't keep the same IP address across requests.

How to set a proxy group

When using standard libraries and languages, specify the groups parameter in the username as groups-UNBLOCKER.

For example, your proxy URL when using the got-scraping JavaScript library will look like this:

const proxyUrl = 'http://groups-UNBLOCKER:<YOUR_PROXY_PASSWORD>@proxy.apify.com:8000';

In the Apify SDK you set groups in your proxy configuration:

import { Actor } from 'apify';

await Actor.init();
// ...
const proxyConfiguration = await Actor.createProxyConfiguration({
    groups: ['UNBLOCKER'],
});
// ...
await Actor.exit();

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 as country-COUNTRY-CODE. For example, to target Japan, set the username to groups-UNBLOCKER,country-JP.

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 you set the country in your proxy configuration using two-letter country codes:

import { Actor } from 'apify';

await Actor.init();
// ...
const proxyConfiguration = await Actor.createProxyConfiguration({
    groups: ['UNBLOCKER'],
    countryCode: 'FR',
});
// ...
await Actor.exit();