Hype Proxies

How to use a proxy with Scrapy

This guide shows you how to integrate HypeProxies with Scrapy to handle IP restrictions, geographical limitations, and rate limiting in your web scraping applications.

Speed

Success

Consistency

Reliability

Flexibility

What is Scrapy

Scrapy is a powerful open-source Python framework for web scraping and crawling. It enables you to write spiders that extract data from websites efficiently. However, when scraping at scale, you often encounter IP bans, geo-restrictions, and rate limits that can halt your data collection efforts.

Proxies solve these challenges by masking your IP address and enabling you to rotate between different network endpoints, helping you avoid detection and maintain consistent access to your target websites.

Scrapy homepage mockup

Prerequisites and setup

Before adding proxies to your project, make sure you have:

  • Python 3.9+ installed

  • Latest Scrapy framework set up (pip install scrapy)

  • HypeProxies account with active proxy credentials

  • Basic familiarity with Scrapy spiders

If you're new to Scrapy, start with the official installation guide and tutorial on creating a project.

Get your HypeProxies credentials

HypeProxies provides unlimited bandwidth, 10 Gbps backbone infrastructure with sub-1ms latency, unlimited concurrency, and 99.9% uptime SLA. Our clean static residential proxies come from trusted U.S. carriers across all 50 states.

Hypeproxies dashboard

Now, to get the credential from HypeProxies, follow the steps below:

  1. Create your HypeProxies account (submit a support ticket for a 24-hour free trial)

  2. Select your proxy plan (ISP, Sneaker, or Ticket proxies)

  3. Complete the checkout process

  4. Access your proxy list from the dashboard

  5. Note the credential format: IP:PORT:USERNAME:PASSWORD

  6. (Optional) Test your proxy connectivity using our proxy checker tool before integrating it into your project

Method 1 – per-request configuration

To quickly test your HypeProxies setup or apply a proxy to specific requests, you can assign it inline using the meta parameter.

import scrapy


class ProxyTestSpider(scrapy.Spider):
    name = "proxy_test"
    start_urls = ["https://ipapi.co/json/"]

    async def start(self):
        proxy = "http://username:password@proxy_ip:proxy_port"

        for url in self.start_urls:
            yield scrapy.Request(url=url, callback=self.parse, meta={"proxy": proxy})

    def parse(self, response):
        data = response.json()
        self.logger.info(f"Response: {data}"

Replace username, password, proxy_ip, and proxy_port with your actual HypeProxies credentials.

Then run your spider: scrapy crawl proxy_test

If successful, you’ll see output like:

This spider sends a request through your proxy to a public IP checker. If everything's set up correctly, the IP in the response will be different from your local IP, confirming that your HypeProxies setup is active.

Method 2 – middleware management

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud

Method 3 – automatic rotation

For rotating through multiple proxies with health monitoring:

Install the rotation package:

pip install scrapy-rotating-proxies

Configure settings:

# settings.py
DOWNLOADER_MIDDLEWARES = {
    'rotating_proxies.middlewares.RotatingProxyMiddleware': 610,
    'rotating_proxies.middlewares.BanDetectionMiddleware': 620,
}

ROTATING_PROXY_LIST = [
    "http://user1:pass1@ip1:port1",
    "http://user2:pass2@ip2:port2",
    "http://user3:pass3@ip3:port3",
]

RETRY_TIMES = 5
RETRY_HTTP_CODES = [403, 429, 500, 502, 503, 504

Your spider code doesn’t need to change. 

The middleware automatically handles proxy selection, rotation, and health monitoring.

Next steps


  • Test proxy behavior with your actual target websites.

  • Adjust concurrency, retries, and headers based on performance.

  • Add error handling and monitoring for production-scale scraping.

Support resources


Start building with stable, high-performance proxies today!

Share on

Stay in the loop

Subscribe to our newsletter for the latest updates, product news, and more.

No spam. Unsubscribe at anytime.

What our clients are saying

What our clients are saying

What our clients are saying

Fast static residential IPs

Proxy plans

Quarterly

10% Off

Monthly

Best value

Starter

Perfect for testing and low-scale usage

$1.40

/ IP

$1.24

/ IP

$35

/month

$31

/month

Quarterly

Cancel at anytime

Pro

Balanced option for daily proxy needs

$1.30

/ IP

$1.16

/ IP

$65

/month

$58

/month

Quarterly

Cancel at anytime

Business

Built for scale and growing demand

$1.25

/ IP

$1.12

/ IP

$125

/month

$112

/month

Quarterly

Cancel at anytime

Enterprise

High-volume power for heavy users

$1.18

/ IP

$1.06

/ IP

$300

/month

$270

/month

Quarterly

Cancel at anytime

Proxies

Bandwidth

Threads

Speed

Support

25 IPs

Unlimited

Unlimited

10GBPS

Standard

50 IPs

Unlimited

Unlimited

10GBPS

Standard

100 IPs

Unlimited

Unlimited

10GBPS

Priority

254 IPs

Subnet

/24 private subnet
on dedicated servers

Unlimited

Unlimited

10GBPS

Dedicated

Crypto

Quarterly

10% Off

Monthly

Starter

Perfect for testing and low-scale usage

$1.40

/ IP

$1.24

/ IP

$35

/month

$31

/month

Quarterly

Cancel at anytime

Get discount below

Proxies

25 IPs

Bandwidth

Unlimited

Threads

Unlimited

Speed

10GBPS

Support

Standard

Pro

Balanced option for daily proxy needs

$1.30

/ IP

$1.16

/ IP

$65

/month

$58

/month

Quarterly

Cancel at anytime

Get discount below

Proxies

50 IPs

Bandwidth

Unlimited

Threads

Unlimited

Speed

10GBPS

Support

Standard

Popular

Business

Built for scale and growing demand

$1.25

/ IP

$1.12

/ IP

$125

/month

$112

/month

Quarterly

Cancel at anytime

Get discount below

Proxies

100 IPs

Bandwidth

Unlimited

Threads

Unlimited

Speed

10GBPS

Support

Priority

Enterprise

High-volume power for heavy users

$1.18

/ IP

$1.06

/ IP

$300

/month

$270

/month

Quarterly

Cancel at anytime

Get discount below

Proxies

254 IPs

Subnet

/24 private subnet
on dedicated servers

Bandwidth

Unlimited

Threads

Unlimited

Speed

10GBPS

Support

Dedicated

Crypto

Quarterly

10% Off

Monthly

Starter

Perfect for testing and low-scale usage

$1.40

/ IP

$1.24

/ IP

$35

/month

$31

/month

Quarterly

Cancel at anytime

Get discount below

Proxies

25 IPs

Bandwidth

Unlimited

Threads

Unlimited

Speed

10GBPS

Support

Standard

Pro

Balanced option for daily proxy needs

$1.30

/ IP

$1.16

/ IP

$65

/month

$58

/month

Quarterly

Cancel at anytime

Get discount below

Proxies

50 IPs

Bandwidth

Unlimited

Threads

Unlimited

Speed

10GBPS

Support

Standard

Popular

Business

Built for scale and growing demand

$1.25

/ IP

$1.12

/ IP

$125

/month

$112

/month

Quarterly

Cancel at anytime

Get discount below

Proxies

100 IPs

Bandwidth

Unlimited

Threads

Unlimited

Speed

10GBPS

Support

Priority

Enterprise

High-volume power for heavy users

$1.18

/ IP

$1.06

/ IP

$300

/month

$270

/month

Quarterly

Cancel at anytime

Get discount below

Proxies

254 IPs

Subnet

/24 private subnet
on dedicated servers

Bandwidth

Unlimited

Threads

Unlimited

Speed

10GBPS

Support

Dedicated

Crypto