Skip to main content

Unblocker

Copy for LLM

Unblocker is a proxy service designed to scrape any website - from pages without protections to those heavily protected by bot detection and CAPTCHA challenges. Instead of building and maintaining your own detection-bypass logic, you can route requests through Unblocker, 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

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

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

Unlike datacenter or residential proxies, Unblocker 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 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 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 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();