ParseHub Proxy: How to Add Custom Proxies to ParseHub

Setup guide · Last reviewed 27 September 2026 · 9 min read

A ParseHub proxy lets your ParseHub projects load pages from the country and network you choose, and spreads large runs across many IPs so sites don’t block them. ParseHub has its own IP rotation on paid plans, and it can also use custom proxies with a username and password. This guide explains when you need proxies in ParseHub, how to add custom proxies step by step, how to format them, and how to get the most from rotating residential proxies in your projects.

Why Use a Proxy with ParseHub

ParseHub is a visual web scraper: you click the data you want on a page, and ParseHub builds a project that collects it from many pages, including sites that load content with JavaScript. When you run a project, ParseHub’s servers visit the pages for you. Without a proxy, every page in a run comes from the same kind of network, and that causes three problems as projects grow.

• Location. Prices, stock, search results and even page layouts often change with the visitor’s country or city. If you need the data a shopper in Germany or Texas sees, the requests have to come from there.
• Scale. A large run sends many requests to one site in a short time. From a single address, that’s easy for the site to rate-limit or block.
• Trust. Many sites treat traffic from data centers more strictly than traffic from home and mobile connections. Residential IPs look like ordinary visitors.

A proxy fixes all three: each page is loaded through an IP in the location you choose, and a pool of IPs spreads the load across many addresses.

ParseHub’s Built-in IP Rotation or Custom Proxies

ParseHub’s pricing lists IP rotation as a feature of its paid plans, Standard and Professional, and not of the free plan. There are two ways to use it:

ParseHub’s help centre describes custom proxies as useful when you want to access a site from a particular country or prefer your own proxies to the ones ParseHub provides. That’s the main reason to add them: control over where your requests come from and what kind of IP they use.

How to Add a ParseHub Proxy

1. Enable custom proxiesEmail ParseHub support at the address in its help centre and ask them to turn on custom proxies for your paid account.
2. Get your proxy detailsIn the ProxyEmpire dashboard, set the location and rotation you want and copy the host, port, username and password.
3. Open project settingsIn ParseHub, open the project, go to Settings and tick Rotate IP Addresses. The Custom Proxy box appears.
4. Paste and runPaste your proxies, one per line, save the project and start a small test run.

Step 1: Ask ParseHub to enable custom proxies

ParseHub’s help centre says custom proxies need to be enabled on your account and asks you to contact its support team to do so. This only applies to paid plans. Do it first, so the Custom Proxy box is there when you need it.

Step 2: Prepare your ProxyEmpire credentials

Open the Proxy Manager in your ProxyEmpire dashboard. Choose rotating residential or rotating mobile, set the country (and region, city or ISP if you need them) and the rotation mode, then copy the host, port, username and password. Your username reflects the targeting and session settings, so copy it after you’ve set everything up. If you don’t have an account yet, the $1.97 trial gives you 100 MB of residential and 50 MB of mobile bandwidth to test with.

Step 3: Add the proxy to your project

In the ParseHub app, open the project you want to use the proxy with and go to its Settings. Tick Rotate IP Addresses, and a Custom Proxy text box appears at the bottom of the screen. Paste your proxy there in the format described in the next section.

Step 4: Save and run a small test

Save the project and start a run with a handful of pages. Check the results: the data should reflect the location you chose, and the run should finish without errors. Then scale up.

ParseHub Proxy Format and Rotation

ParseHub’s help centre gives the custom proxy format as the address, the port, the username and the password, separated by colons. With ProxyEmpire, the address can be the hostname or a direct IP address. With the hostname it looks like this:

v2.proxyempire.io:5000:USERNAME:PASSWORD

To rotate through several proxies, add each on its own line; ParseHub rotates between the lines you paste. With a rotating residential endpoint, a single line can already give you a new IP for each request, so you have two ways to set it up:

Keep the username and password exactly as the dashboard shows them, with no spaces around the colons. If you change the targeting later, copy the new username into ParseHub too.

Which Proxies to Use with ParseHub

• Rotating residential proxies are the default choice for ParseHub. They come from real home broadband connections in 179 countries and territories, with targeting down to city, ZIP, ISP and ASN, from $3.50 for one GB down to $1.50/GB.
• Rotating mobile proxies use 4G carrier networks in 174 countries, from $2.00/GB. Use them for mobile versions of sites and for sites that are strict with home IPs.
• Static residential proxies give you a fixed residential IP from $2.00 a month, sold in 24 countries, for projects that must always come from one address.

Datacenter proxies are the cheapest option, from $0.35/GB, and fine for sites without strong bot checks. Unused bandwidth rolls over on every plan, so a quiet month doesn’t cost you anything.

Tips for Reliable ParseHub Runs with Proxies

Start small. Run five or ten pages first, check the data, then scale. It’s much cheaper to find a problem in a test than halfway through a big run.

Add waits for slow pages. A proxy adds a little time to every request. If your project clicks through pages or waits for content to appear, give it a bit more time so it doesn’t move on before the data loads.

Only collect what you need. Every page ParseHub loads uses bandwidth, and you pay per GB of proxy traffic. Narrow your project to the pages and elements you actually need.

Keep sessions for logins. If a project signs in to a site, use a sticky session so the whole run keeps one IP. A login that jumps between IPs is more likely to be challenged.

Watch scheduled runs. ParseHub’s paid plans can run projects on a schedule. A scheduled project keeps using the proxy line saved in its settings, so if you change the targeting in the ProxyEmpire dashboard, update the username in every scheduled project too, and make sure your account has enough bandwidth for the runs you’ve planned.

Respect the site. Collect public data at a sensible pace and keep to each site’s terms.

Troubleshooting ParseHub Proxy Problems

To check your credentials outside ParseHub, test them with a single command: curl -x http://v2.proxyempire.io:5000 -U "USERNAME:PASSWORD" https://api.ipify.org. If that returns an IP from the location you chose, the credentials are fine and the issue is in the ParseHub setup. The proxy troubleshooting guide covers other causes, and if you’d rather write code than click, our Puppeteer proxy guide shows the same setup in a script.

ParseHub Proxy FAQ

References

1. ParseHub Help Center — Adding Custom Proxies to ParseHub (for all Paid Plans). help.parsehub.com/hc/en-us/articles/115001324853
2. ParseHub — Pricing (plans and IP rotation). parsehub.com/pricing
3. ProxyEmpire docs — What connection protocols do you support? proxyempire.io/docs/what-connection-protocols-do-you-support
4. curl — manual page (-x, -U). curl.se/docs/manpage.html