Proxy
Configure proxy routing on your individual scrapers to mask your IP, bypass geo-restrictions, and improve scraping reliability.
Proxy Settings let you attach a proxy to a specific scraper so that every time that scraper runs — manually, via schedule, or through the API — its requests are routed through the configured proxy.
This is useful when you need to:
- Mask your scraper's IP address to avoid detection or rate-limiting
- Access region-locked or geo-restricted content from a specific country
- Route traffic through your own private proxy infrastructure
How is this different from the Proxy Scraper?
Proxy Settings (this page) is a configuration option inside an existing scraper. You attach a proxy so the scraper's requests are routed through it. The scraper defines what to scrape; the proxy setting controls how the traffic is routed.
The Proxy Scraper (covered in Proxy Scraper) is a standalone tool on the Proxies page. You provide a URL and a proxy country, and MrScraper handles both the scraping and the proxying together.
How to Configure Proxy Settings
Open Your Scraper Settings
- Select the scraper you want to configure in the Scrapers page.
- Click Settings → Proxy Settings.
Enable and Configure Proxy
In the Proxy Settings panel, you can select one of the following options:
Option 1: Use MrScraper's Built-in Proxy
- Toggle Enable Proxy.
- Under Proxy Type, choose MrScraper Proxy.
- Select your desired location/region from the dropdown list.
- Each region provides a local IP address, ideal for geo-targeted scraping.
- Click Save Settings.
Note
The scraper will now route traffic through the selected country's proxy network, allowing access to region-specific or restricted content.
Option 2: Use Custom Proxy
Warning
Only use proxies from trusted providers to ensure your data remains secure.
- Toggle Enable Proxy.
- Under Proxy Type, choose Custom Proxy.
- Enter your proxy URL in one of the following formats:
http://username:password@host:portorhttps://host:port. - Click Save Settings to apply your configuration.
Tip
Use your own proxy if you have an existing provider, private IP pool, or dedicated proxy infrastructure.
Option 3: Route the Entire Request Through the Proxy
- Toggle Route entire request through proxy. This routes page subresources—including CSS, JavaScript, and images—through the proxy so the page loads fully and scripts run reliably.
- Click Save Settings to apply your configuration.
Tip
Try scraping with this option turned off first to minimize bandwidth usage. If the scrape fails or the page does not load correctly, turn it on. Some websites block CSS, JavaScript, images, or other subresources unless they are also routed through the proxy. Enabling this option can improve reliability, but it uses more bandwidth.
Option 3: Route the Entire Request Through the Proxy
- Toggle Route entire request through proxy. This routes page subresources—including CSS, JavaScript, and images—through the proxy so the page loads fully and scripts run reliably.
- Click Save Settings to apply your configuration.
Tip
Try scraping with this option turned off first to minimize bandwidth usage. If the scrape fails or the page does not load correctly, turn it on. Some websites block CSS, JavaScript, images, or other subresources unless they are also routed through the proxy. Enabling this option can improve reliability, but it uses more bandwidth.
MrScraper Built-in Proxy Countries
Below is the full list of supported countries and regions available for MrScraper's built-in proxies:
| Country/Region Name | Country/Region Name | Country/Region Name | Country/Region Name |
|---|---|---|---|
| Afghanistan | Albania | Algeria | American Samoa |
| Andorra | Angola | Anguilla | Antarctica |
| Antigua and Barbuda | Argentina | Armenia | Aruba |
| Australia | Austria | Azerbaijan | Bahamas |
| Bahrain | Bangladesh | Barbados | Belarus |
| Belgium | Belize | Benin | Bermuda |
| Bhutan | Bolivia (Plurinational State of) | Bonaire, Sint Eustatius and Saba | Bosnia and Herzegovina |
| Botswana | Bouvet Island | Brazil | British Indian Ocean Territory |
| Brunei Darussalam | Bulgaria | Burkina Faso | Burundi |
| Cambodia | Cameroon | Canada | Cape Verde |
| Cayman Islands | Central African Republic | Chad | Chile |
| China | Christmas Island | Cocos (Keeling) Islands | Colombia |
| Comoros | Congo | Congo (Democratic Republic of the) | Cook Islands |
| Costa Rica | Croatia | Cuba | Curaçao |
| Cyprus | Czech Republic | Côte d'Ivoire | Denmark |
| Djibouti | Dominica | Dominican Republic | Ecuador |
| Egypt | El Salvador | Equatorial Guinea | Eritrea |
| Estonia | Eswatini | Ethiopia | Falkland Islands (Malvinas) |
| Faroe Islands | Fiji | Finland | France |
| French Guiana | French Polynesia | French Southern Territories | Gabon |
| Gambia | Georgia | Germany | Ghana |
| Gibraltar | Greece | Greenland | Grenada |
| Guadeloupe | Guam | Guatemala | Guernsey |
| Guinea | Guinea-Bissau | Guyana | Haiti |
| Heard Island and McDonald Islands | Holy See (Vatican City State) | Honduras | Hong Kong |
| Hungary | Iceland | India | Indonesia |
| Iran (Islamic Republic of) | Iraq | Ireland | Isle of Man |
| Israel | Italy | Jamaica | Japan |
| Jersey | Jordan | Kazakhstan | Kenya |
| Kiribati | Korea (Democratic People's Republic of) | Korea (Republic of) | Kuwait |
| Kyrgyzstan | Lao People's Democratic Republic | Latvia | Lebanon |
| Lesotho | Liberia | Libya | Liechtenstein |
| Lithuania | Luxembourg | Macao | North Macedonia |
| Madagascar | Malawi | Malaysia | Maldives |
| Mali | Malta | Marshall Islands | Martinique |
| Mauritania | Mauritius | Mayotte | Mexico |
| Micronesia (Federated States of) | Moldova (Republic of) | Monaco | Mongolia |
| Montenegro | Montserrat | Morocco | Mozambique |
| Myanmar | Namibia | Nauru | Nepal |
| Netherlands | New Caledonia | New Zealand | Nicaragua |
| Niger | Nigeria | Niue | Norfolk Island |
| Northern Mariana Islands | Norway | Oman | Pakistan |
| Palau | Palestine, State of | Panama | Papua New Guinea |
| Paraguay | Peru | Philippines | Pitcairn |
| Poland | Portugal | Puerto Rico | Qatar |
| Romania | Russian Federation | Rwanda | Réunion |
| Saint Barthélemy | Saint Helena, Ascension and Tristan da Cunha | Saint Kitts and Nevis | Saint Lucia |
| Saint Martin (French part) | Saint Pierre and Miquelon | Saint Vincent and the Grenadines | Samoa |
| San Marino | Sao Tome and Principe | Saudi Arabia | Senegal |
| Serbia | Seychelles | Sierra Leone | Singapore |
| Sint Maarten (Dutch part) | Slovakia | Slovenia | Solomon Islands |
| Somalia | South Africa | South Georgia and the South Sandwich Islands | South Sudan |
| Spain | Sri Lanka | Sudan | Suriname |
| Svalbard and Jan Mayen | Sweden | Switzerland | Syrian Arab Republic |
| Taiwan (Province of China) | Tajikistan | Tanzania, United Republic of | Thailand |
| Timor-Leste | Togo | Tokelau | Tonga |
| Trinidad and Tobago | Tunisia | Turkey | Turkmenistan |
| Turks and Caicos Islands | Tuvalu | Uganda | Ukraine |
| United Arab Emirates | United Kingdom | United States | United States Minor Outlying Islands |
| Uruguay | Uzbekistan | Vanuatu | Venezuela (Bolivarian Republic of) |
| Viet Nam | Virgin Islands (British) | Virgin Islands (U.S.) | Wallis and Futuna |
| Western Sahara | Yemen | Zambia | Zimbabwe |
| Åland Islands |
Tip
Use built-in proxies when you need to scrape data from region-locked websites or compare results between countries (for example, e-commerce prices or job listings).