What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Apify supports custom proxy URLs in two ways: enter them in an Actor’s Input tab when its schema exposes Proxy and browser configuration, or create a proxy configuration in the Apify SDK and request a generated URL. Custom endpoints are supplied through proxy_urls in Python or proxyUrls in JavaScript. Do not combine those settings with Apify Proxy options in one configuration; the JavaScript SDK documents that combination as an initialization error.
Your proxy provider—not Apify—determines the endpoint format, credentials, rotation, location, and authentication method. Keep credentials out of source code and logs.
Choose the setup that fits your Actor
| Route | Best for | Requirement |
|---|---|---|
| Apify Console | A one-time or occasional run | The Actor input schema must expose Proxy and browser configuration |
| SDK configuration | Reusable crawlers, scheduled jobs, and dynamic proxy selection | An installed Apify SDK version whose API matches your code |
Apify’s documentation confirms that you can use your own proxies in both Console and the SDK (official setup guide). The two routes configure the same general idea—user-supplied proxy endpoints—but the exact fields and code names are different.
Use a custom proxy in Apify Console
- Open the Actor in Apify Console and select the Input tab.
- Look for Proxy and browser configuration.
- If that section exists, enter the proxy URLs supplied by your provider. Follow that provider’s required scheme, host, port, credentials, and rotation format.
- Save the input and run the Actor.
The section is controlled by the Actor’s input schema, so it will not appear for every Actor. If you cannot find it, use the SDK route below or modify the Actor input schema only if you maintain that Actor.
#1 Best Overall
- Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
- Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
- Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
- Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
- 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
What a proxy URL usually contains
A provider may give you an HTTP, HTTPS, or SOCKS endpoint, optionally with a username and password. Do not copy the hostname, port, or password from Apify’s managed proxy instructions into a third-party configuration. Apify Proxy has its own account access and connection settings; an external provider’s URL format is provider-specific.
Configure custom proxies with the Python SDK
The Python flow is: create a proxy configuration with proxy_urls, call new_url(), then pass the resulting URL to the crawler or HTTP client used by your Actor. The official Python documentation shows this shape:
from apify import Actor
proxy_cfg = await Actor.create_proxy_configuration(
proxy_urls=[
"http://proxy-1.example:8080",
"http://proxy-2.example:8080",
],
)
proxy_url = await proxy_cfg.new_url()
print(proxy_url)
The example hosts are placeholders and will not work as written. Replace them with endpoints from your provider. Install and use the API that matches your project’s SDK version; Apify’s reference pages identify versioned APIs, so check the Python proxy-management guide and Python ProxyConfiguration reference before copying code.
Attach the generated URL to an HTTP request
How you attach the URL depends on your HTTP library. For an HTTP client that accepts a proxy mapping, use the generated value for the appropriate protocol:
Rank #2
- 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
- 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
- Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
- 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
- What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
import httpx
async with httpx.AsyncClient(
proxies={"http://": proxy_url, "https://": proxy_url},
timeout=60,
) as client:
response = await client.get("https://example.com")
response.raise_for_status()
print(response.text[:200])
Some libraries use a single proxy argument, while crawler frameworks accept a proxy configuration object. Follow the client’s own API rather than assuming that every Actor uses the same request mechanism.
Generate URLs dynamically
Python also documents new_url_function for generating a custom URL dynamically. This is useful when your provider issues short-lived credentials or you must select an endpoint per request. Keep the function deterministic enough to debug and never print its credentials.
Configure custom proxies with the JavaScript SDK
JavaScript uses the proxyUrls option (capital “U”). A minimal configuration is:
import { ProxyConfiguration } from 'apify';
const proxyConfiguration = new ProxyConfiguration({
proxyUrls: [
'http://proxy-1.example:8080',
'http://proxy-2.example:8080',
],
});
const proxyUrl = await proxyConfiguration.newUrl();
console.log(proxyUrl);
Use the generated URL with your crawler or request library. The option names and constructor behavior are version-sensitive; verify them against the JavaScript ProxyConfigurationOptions reference. JavaScript also documents newUrlFunction for dynamic generation.
Do these 3 things before closing this tab:
1Repair Windows errors before they cause bigger problems2Fix the driver behind crashes, sound loss and screen glitches3Clear out junk files and repair common Windows errorsRank #3
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
Do not mix custom URLs with Apify Proxy options
Choose one mode for a configuration. A custom-URL configuration should not also set Apify Proxy groups, country options, or other Apify-managed proxy settings. The JavaScript reference says combining custom proxies with Apify Proxy options causes an initialization error. If you need Apify’s managed service, configure that mode separately; if you need your provider’s endpoints, remove the Apify Proxy fields.
Custom proxy versus Apify Proxy
| Question | Custom proxy | Apify Proxy |
|---|---|---|
| Where does the endpoint come from? | A provider you select and supply | Apify’s managed service |
| Configuration input | proxy_urls or proxyUrls |
Apify-specific groups and connection settings |
| Who defines credentials and rotation? | Your provider | Apify account and service settings |
| Can both be in one SDK configuration? | No; keep modes separate | No; keep modes separate |
Apify’s Proxy documentation describes its own hostname, port, and password-based connection. It also warns that use of the Apify Proxy password is charged to the account and that the password is sent unencrypted when used with the documented HTTP protocol. Those details do not describe every external provider.
Credentials, rotation, and request behavior
- Credentials: store proxy URLs in environment variables or a secret store. Do not commit them, include them in public examples, or log complete URLs.
- Rotation: passing multiple URLs lets the SDK choose among configured endpoints according to its implementation. A provider may instead encode rotation in one gateway URL; consult that provider’s documentation.
- Scheme support: use the scheme your client and provider both support. An HTTP proxy URL is not automatically interchangeable with a SOCKS URL.
- Authentication: preserve URL encoding for special characters in usernames or passwords, or use the client’s dedicated credential fields.
- Geography and session: country, city, sticky-session, and ASN behavior belongs to the proxy provider unless the provider documents URL parameters for it.
Testing and reliability checklist
- Test one endpoint outside the full crawler with a harmless URL.
- Confirm the observed public IP and expected region using a service approved by your organization.
- Run a small Actor input before starting a large crawl.
- Record status codes, timeouts, and proxy failures without recording secrets.
- Set client timeouts and retry limits appropriate to the provider’s documented behavior.
A proxy can add latency or fail independently of the target site. Do not infer a success rate, speed improvement, pool size, or geographic coverage unless your provider publishes that figure for the relevant plan and date.
Troubleshooting common failures
The Console field is missing
Cause: the Actor schema does not define Proxy and browser configuration. Fix: use SDK configuration, or update the schema if you control the Actor. The Console route is not universal.
Quick wins for a faster PC:
Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Clear out junk files and repair common Windows errorsFree Scan →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Rank #4
- Dual Converters, Infinite Potential:Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
- Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
- Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
- Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
- Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
Initialization fails after adding proxy settings
Cause: custom URLs and Apify Proxy options were supplied together. Fix: remove one mode’s options and create a configuration for only custom endpoints or only Apify Proxy.
Authentication fails
Cause: incorrect credentials, unescaped special characters, or a provider-specific authentication requirement. Fix: copy the provider’s exact URL format, URL-encode credentials, and test the endpoint with the provider’s recommended client.
Requests time out
Cause: an unavailable endpoint, overloaded pool, blocked destination, or timeout that is too short. Fix: test each endpoint individually, remove unhealthy URLs, increase the client timeout conservatively, and check provider status and destination restrictions.
The target blocks the request
Cause: the target may distrust the proxy’s IP range, detect automation, or require browser behavior. Fix: verify that the provider permits the destination, use the target’s compliant access method, and do not treat a proxy as a bypass for authentication, CAPTCHA, or access controls.
Best Value
- 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
- Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
- Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
- HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
- What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
Code works locally but not in the Actor
Cause: missing environment variables, a different SDK version, or a crawler that does not consume the generated URL. Fix: print only non-sensitive configuration diagnostics, pin and verify the SDK version, and attach the URL through the crawler’s documented proxy hook.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Or skip the browser setup
If your next step is taking a clean screenshot of a page reached through your workflow, ScreenshotNeo provides a one-request screenshot API and MCP server. It removes cookie or consent banners, newsletter popups, and chat widgets before capture; bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, with the result identifying the page verdict and billing status in response headers. AI agents can call its take_screenshot, get_page_info, and capture_pdf MCP tools.
Use the ScreenshotNeo API documentation for authentication and options. cURL:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp
Python:
import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)
Node.js:
const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);
ScreenshotNeo includes 1,000 screenshots per month free with no card; paid plans start at $5 for 3,000. Create a free ScreenshotNeo account.
Free tools Windows power users keep installed
One-click scans. No signup required.
Frequently Asked Questions
Can I use a SOCKS proxy in Apify?
Only if the Actor’s request library and your installed SDK support the provider’s SOCKS scheme. Check both APIs and the provider’s connection instructions before deployment.
Should I put proxy URLs in the Actor source code?
No. Use secrets or environment variables and keep credentials out of source control, logs, and shared examples.
Does a custom proxy automatically provide a country-specific IP?
No. Location and session behavior come from the proxy provider and the endpoints or plan you selected.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

