AP
Scraping Frameworks

Apify proxy integration

Apify actors accept custom proxy URLs through their proxyConfiguration input. Provide your Aethyn endpoint so actors and the Apify SDK route requests through residential IPs instead of the default pool.

Setup steps

  1. 1In the actor input, set proxyConfiguration to use custom proxy URLs.
  2. 2Add your Aethyn proxy URL to proxyUrls.
  3. 3Or pass it programmatically in the SDK's ProxyConfiguration.
  4. 4Add targeting suffixes in the username.

Code

Apify SDK custom proxy
import { Actor } from "apify";

await Actor.init();

const proxyConfiguration = await Actor.createProxyConfiguration({
  proxyUrls: ["http://aethyn-XXXXX-country-us:PASSWORD@proxy.aethyn.io:2099"],
});

const info = await proxyConfiguration.newProxyInfo();
console.log(info.url);

await Actor.exit();

Replace aethyn-XXXXX and PASSWORD with your dashboard credentials. See the full targeting reference and protocol/port list.

Tips

  • Custom proxy URLs override Apify's built-in proxy for that run.
  • Combine with Crawlee crawlers running inside the actor.
  • Use sticky sessions when an actor needs a stable IP.

Apify proxy FAQ

Can I use Aethyn instead of Apify Proxy?
Yes. Provide your Aethyn proxy URL via proxyUrls in the actor's proxyConfiguration to route through Aethyn's residential network.

Ready to wire up Apify?

Get your credentials and route your first Apify request through residential IPs in minutes.

Docs, solutions & blog

Related integrations

All integrations