Proxies for Apify

Before you start

You need an active plan, your gateway credentials from the dashboard, and either your server IP whitelisted or a user and password pair. Replace USER:PASS in the examples with your real credentials.

The rotating port gives a new IP on every request. Sticky ports hold one address for the life of the session, and both live on the same host, so you choose by port rather than by product.

The gotcha worth knowing

Passing a single rotating URL is enough. The gateway rotates per request, so you do not need to supply a list of many proxy URLs the way you would with static IPs.

Configuration

Apify actors accept a proxy configuration object. Point it at the gateway as a custom proxy URL rather than using the built in pool.

import { Actor } from 'apify';
import { CheerioCrawler } from 'crawlee';

await Actor.init();

const proxyConfiguration = await Actor.createProxyConfiguration({
    proxyUrls: ['http://USER:PASS@gateway.proxyrotator.com:11000'],
});

const crawler = new CheerioCrawler({
    proxyConfiguration,
    async requestHandler({ request, body }) {
        console.log(request.url, body.length);
    },
});

await crawler.run(['https://api.ipify.org']);
await Actor.exit();

Where to go next

Running more than one tool against the same gateway is normal. These cover the others.

• All integration guides, setup notes for every tool we cover
• Guides and tutorials, the concepts behind the config, including when to rotate and when not to
• n8n setup, another library or framework wired to the same gateway
• Octoparse setup, another library or framework wired to the same gateway
• Rotating proxies, a new IP per request, which is the default for crawling