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
- 1In the actor input, set proxyConfiguration to use custom proxy URLs.
- 2Add your Aethyn proxy URL to proxyUrls.
- 3Or pass it programmatically in the SDK's ProxyConfiguration.
- 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.
Docs, solutions & blog
Premium residential proxiesCost-efficient rotating residential pool from €2.00/GB for bulk scraping and monitoring.Elite residential proxiesCurated high-trust pool with city and ISP targeting for hard anti-bot targets.Quickstart docsCredentials, endpoints, and your first proxied request.Proxy glossaryPlain-English definitions for residential proxies, rotation, anti-bot, and scraping terms.