Cloud scraping platform with actor marketplace. Use KnoxProxy as an external proxy provider in Apify actors for better geo-targeting and lower per-GB costs.
Go to your actor settings or create a new actor.
In actor input, set proxy configuration to "Custom proxies".
{
"proxyConfiguration": {
"useApifyProxy": false,
"proxyUrls": ["http://USER:PASS@gw.knoxproxy.com:7000"]
}
}Add country to proxy URL.
"proxyUrls": ["http://USER-country-us:PASS@gw.knoxproxy.com:7000"]Add multiple proxy URLs for rotation across countries.
"proxyUrls": [
"http://USER-country-us:PASS@gw.knoxproxy.com:7000",
"http://USER-country-gb:PASS@gw.knoxproxy.com:7000",
"http://USER-country-de:PASS@gw.knoxproxy.com:7000"
]Run the actor and check logs for proxy connection status.
Check actor output for correct geo-targeted results.
/**
* KnoxProxy + Apify Actor -- custom proxy configuration.
*/
import { Actor } from 'apify';
import { CheerioCrawler } from 'crawlee';
await Actor.init();
const proxyConfiguration = await Actor.createProxyConfiguration({
proxyUrls: ['http://USER:PASS@gw.knoxproxy.com:7000'],
});
const crawler = new CheerioCrawler({
proxyConfiguration,
async requestHandler({ request, $ }) {
const title = $('title').text();
await Actor.pushData({ url: request.url, title });
},
});
await crawler.run(['https://example.com']);
await Actor.exit();Apify rotates through proxyUrls automatically. Each URL gets a new KnoxProxy IP per request. Add multiple country-targeted URLs for geo-rotation.
| Problem | Fix |
|---|---|
| Proxy connection refused | Verify URL format: http://USER:PASS@gw.knoxproxy.com:7000. No trailing slash. |
| Actor timeout | Increase request timeout in crawler options. |
USER-country-de-city-berlin-session-profile07Order matters -- geo flags before the session flag. The session name is free text; use the profile ID so the mapping is self-documenting. Password stays as issued; no flags belong there. HTTP on :7000, SOCKS5 on :7001, same credentials.
KnoxProxy residential costs $2.10/GB versus $8/GB and up for the built-in Apify residential proxy, so switching cuts bandwidth spend substantially on volume workloads. Set useApifyProxy to false and pass KnoxProxy URLs in proxyUrls instead; Crawlee then rotates through them automatically, with no change to the rest of your actor code.
Yes. Crawlee, the crawling library behind the Apify SDK, accepts custom proxy setups through createProxyConfiguration with a proxyUrls array, where each entry is a full KnoxProxy address including credentials. Pass that configuration into a CheerioCrawler or PlaywrightCrawler instance, and Crawlee rotates automatically through the listed URLs, handing each outgoing request a fresh KnoxProxy IP.
Yes. In the actor input JSON, set useApifyProxy to false and list your KnoxProxy addresses under proxyUrls, the same configuration used for local runs. Apify then connects to the KnoxProxy gateway from its own cloud servers, so cloud actors reach target sites through KnoxProxy exit IPs exactly like a local test run.
Yes. The proxyUrls array accepts any mix of proxy addresses, so you can list Apify proxy URLs alongside KnoxProxy URLs in the same actor configuration. Crawlee rotates between every entry in the array per request, which is useful for comparing providers or falling back to a second source if one connection fails.
Rotating residential proxies -- 5 minutes setup, instant activation, 14-day money-back guarantee.