Save 5% every month: use code 5OFFSTORM at checkout
Home / Guides / Screaming Frog

How to set up a proxy in Screaming Frog SEO Spider

Open File > Settings > Proxy (on macOS: Screaming Frog SEO Spider > Settings > Proxy; before version 19 it was Configuration > System > Proxy). Tick Use Proxy Server, enter the gateway IP and port, save, and restart the SEO Spider. Then set Configuration > Speed so Max Threads stays below your plan’s thread count.

Updated October 2026SEO tools

Screaming Frog SEO Spider is the desktop crawler most SEOs use for technical audits: it follows links like a search engine bot and reports status codes, redirects, titles, canonicals, hreflang and much more. It runs from your own computer, so by default every request comes from your office or home IP.

A proxy helps in a few situations: a site’s firewall starts returning 403 or 429 halfway through a crawl, you need to see a site as visitors in the USA or the EU see it, you audit competitors and don’t want to burn your office IP, or your company network routes traffic through a proxy anyway. The setting itself takes a minute. What goes wrong is everything around it: forgetting the restart, more crawl threads than the proxy plan allows, JavaScript rendering that multiplies connections, and choosing a proxy type that doesn’t match a one-proxy tool.

This guide walks through the settings in current versions, the thread math for normal and rendered crawls, which Storm product fits which job, and the errors you’ll see when something is off.

Which Storm plan fits

Screaming Frog accepts only one proxy address, so a rotating gateway is the natural fit: one IP:PORT in the settings, and a different exit IP for each new connection from a pool of 700,000+. A 40-thread plan covers a normal crawl with room to spare. If you only crawl your own sites and want the server to recognise you, a private dedicated proxy gives you one static IP to put on the site’s allowlist.

Rotating proxies (from $14/mo): 700,000+ IPs behind fixed gateway IP:PORTs. New IP on every request, or every 3 or 15 minutes. USA, EU, USA+EU or Worldwide. Unlimited bandwidth on every plan.

Get 40 threads for $39/mo See all rotating proxies plans

Before you start

  1. Log in to the member area and copy your gateway IP:PORTs. They never change; the rotation happens on our side.
  2. Add the public IP of the computer or server that will run your tool under Authorized IPs, click Save, and allow up to 15 minutes before testing. Rotating and residential proxies use IP authentication, so there is no username or password.
  3. Dedicated proxies work with either IP authentication or a username and password. Use user:pass if your IP changes or the tool runs on several machines.
  4. Count your threads: the tool’s total open connections must stay within your plan (for example 40 threads on the 40-thread plan).

Add a proxy to Screaming Frog, step by step

  1. Authorize the computer that runs the SEO Spider

    Rotating and residential gateways work by IP authorization. Find the public IP of the machine running Screaming Frog (your PC, or the VPS if you crawl from a server), add it under Authorized IPs in the member area, click Save, and allow up to 15 minutes. A private dedicated proxy can use username and password instead.

  2. Open the proxy settings

    On Windows and Linux go to File > Settings > Proxy. On macOS go to Screaming Frog SEO Spider > Settings > Proxy. Version 19 moved system settings there; older builds have them under Configuration > System > Proxy.

  3. Enter the gateway

    Tick Use Proxy Server. Put the gateway IP in the address field and the port in the port field, with no http:// prefix. Leave the credentials empty for rotating and residential gateways. For a dedicated proxy with a login, enter the username and password in the same window.

  4. Save and restart

    Click OK, then close and reopen the SEO Spider. The proxy setting only takes effect after a restart, which is the most common reason people think “the proxy doesn’t work”.

  5. Set crawl speed to fit your plan

    Open Configuration > Speed. The default is 5 threads, which is gentle and fits any plan. Raise Max Threads only as far as your plan and the target site allow, and use Max URI/s when you want a fixed request rate. The thread table below gives numbers.

  6. Run a short test crawl

    Crawl a page that shows your IP, or a small site you know, in List mode with a few URLs. Check the Response Codes tab: 200s mean the route works. Connection errors on every URL mean the proxy isn’t accepting you yet: a reset connection points to authorization, a refused one to a wrong address or port.

  7. Turn the proxy off when you don’t need it

    Untick Use Proxy Server and restart. There are no exceptions in this setting, so while it’s on, all HTTP and HTTPS traffic from the SEO Spider goes through the proxy, including connections to API integrations.

Quick reference: where every setting lives

Menu paths from the official SEO Spider user guide, for version 19 and later. Replace GATEWAY_IP and PORT with your gateway.

Proxy settings
Windows / Linux : File > Settings > Proxy
macOS           : Screaming Frog SEO Spider > Settings > Proxy
Before v19      : Configuration > System > Proxy

[x] Use Proxy Server
Address : GATEWAY_IP          (no http:// prefix)
Port    : PORT
Login   : empty for rotating/residential; user + pass only for dedicated
-> OK, then restart the SEO Spider
Crawl speed and rendering
Configuration > Speed
  Max Threads : 5 (default) ... see the thread table for your plan
  Max URI/s   : optional fixed rate, e.g. 2 for a fragile site

Configuration > Spider > Rendering
  Text Only   : raw HTML, ~1 connection per thread
  JavaScript  : headless Chrome loads JS, CSS and images per page
                -> budget about 10 plan threads per rendering thread

Configuration > User-Agent   (default identifies as Screaming Frog SEO Spider)
Configuration > Robots.txt   (Respect robots.txt is the default)

Thread math: crawl threads vs plan threads

The SEO Spider’s Max Threads is the number of URLs it fetches at the same time. Your rotating plan’s thread count is the number of connections that can be open through the gateway at the same time. Keep the first comfortably below the second, because the crawler also opens connections for robots.txt, redirects and, with rendering on, page resources.

  • 10 threads ($14, test package): keep the default 5 crawl threads. Good for checking the setup, small for real audits.
  • 40 threads ($39): up to about 30 crawl threads in text-only mode, or 3 to 4 with JavaScript rendering.
  • 80 threads ($59): about 60 text-only, or 6 to 8 rendered.
  • 150 threads ($97): about 110 text-only, or around 15 rendered.

More threads isn’t always faster. The official FAQ notes that the website itself usually sets the pace, and a small shared-hosting site will slow down or start returning 5xx errors long before you reach 30 threads. If something else uses the same plan at the same time (a scraper, a rank tracker, ScrapeBox), subtract its threads first.

Why JavaScript rendering needs a bigger plan

With Configuration > Spider > Rendering set to JavaScript, the SEO Spider loads each page in headless Chrome, along with the scripts, stylesheets and images it references, waits for the AJAX timeout (5 seconds by default) and then reads the rendered HTML. A browser fetches those resources over several parallel connections, so one rendering thread behaves like a browser tab: plan on around 10 proxy threads for each one.

So a crawl that runs fine at 30 threads in text-only mode can produce timeouts and connection errors at the same setting with rendering switched on. Drop Max Threads when you enable rendering, or move to a bigger plan. Bandwidth isn’t a concern on Storm plans because it’s unlimited, which matters here: rendered crawls download far more data than raw HTML crawls.

Render only when you need to: for client-side frameworks, or to compare raw and rendered HTML. Most audit checks work in text-only mode at a fraction of the load.

Rotating, residential or dedicated: which fits a crawler

Screaming Frog takes exactly one proxy server, and that shapes the choice.

  • Rotating datacenter, Main gateway (best default): one address, a new exit IP per connection. A crawl’s requests spread over many IPs, which keeps any single IP well under a site’s per-IP rate limit. Pick the USA or EU location to match the market you audit, since many sites redirect or change content by visitor region.
  • Rotating, 15-minute gateway: one IP for 15 minutes. Useful when a site ties a session or a consent cookie to the visitor IP and you want consistent results within a crawl section.
  • Residential: one port is one IP at a time, changing every 5 minutes, with all threads on that port sharing it. In a one-proxy tool you crawl from a single household IP at a time, so keep threads low. It fits sites that refuse datacenter ranges, not big fast crawls.
  • Private dedicated: one static IP that only you use. Best for crawling your own or a client’s site behind a firewall or CDN, because you can give that IP to the developers for their allowlist.

Skip the 3-minute gateway here: it’s a USA-only mix of IP types meant for account sign-ups, social sites and browsing, not for crawling. And keep in mind that Screaming Frog audits websites, not Google’s results pages. If you also scrape search engines with another tool, use the Main gateway and no more than 25% of your threads for that job.

Crawling your own sites vs competitors, responsibly

For your own or a client’s site, a proxy is often the wrong fix for blocks. The official FAQ recommends asking the site owner to allowlist your IP and the Screaming Frog user agent when a firewall returns 403 or 429. A dedicated proxy makes that easy: one fixed IP, wherever you crawl from. Agree on a crawl rate with the developers before you run a big audit on a production server.

For competitor sites, stay polite. Keep Respect robots.txt on, set Max URI/s to a few URLs per second on smaller sites, and crawl outside the site’s peak hours. A rotating gateway spreads your requests across IPs, but your total load on their server is the same, so the rate limit you set is what makes a crawl responsible. A 429 is a signal to slow down, not to add threads.

Changing the user agent under Configuration > User-Agent to a browser string avoids blanket blocks on crawler names, but don’t impersonate Googlebot on sites you don’t own.

Common errors and fixes

Every URL shows Connection RefusedNothing answered on that address: the gateway IP or port has a typo, or a firewall blocks it. Copy the gateway again from the member area and restart the SEO Spider after any proxy change.
Every URL fails with a connection error or no responseYour IP isn’t authorized yet, so the gateway accepts the connection and drops it. Check Authorized IPs, wait 15 minutes after saving, and restart the SEO Spider.
Proxy entered, but crawls still come from your own IPThe SEO Spider wasn’t restarted, or Use Proxy Server isn’t ticked. Settings only apply after a restart.
Connection Timeout on many URLsMax Threads is above your plan’s threads (especially with JavaScript rendering), or the target is slow. Lower threads, set a Max URI/s, and raise the response timeout under Configuration > Spider > Advanced.
Lots of 403 ForbiddenA firewall or bot protection is refusing the request. On your own sites, ask for an allowlist of your dedicated IP and the user agent. On other sites, slow down and check robots.txt.
429 Too Many Requests part-way throughPer-IP or per-site rate limiting. Use the Main rotating gateway, reduce Max Threads and set Max URI/s. See the 429 guide.
API integrations (Search Console, GA, PageSpeed) fail after enabling the proxyAll traffic goes through the proxy with no exceptions. Run the API pulls with the proxy off, or check that the gateway location doesn’t trigger a security prompt.
Crawl suddenly drops connections on a residential portThe port changed its IP at the 5-minute mark. Keep threads low and re-crawl failed URLs from the Response Codes tab.

FAQ

Where is the proxy setting in the new Screaming Frog?

Since version 19 it’s under File > Settings > Proxy on Windows and Linux, and Screaming Frog SEO Spider > Settings > Proxy on macOS. Older versions had it at Configuration > System > Proxy.

Can I add a list of proxies to Screaming Frog?

No. Only one proxy server can be configured. Use a rotating gateway, which is one address that rotates the exit IP for you.

Do I need a username and password for Storm rotating proxies in Screaming Frog?

No. Leave the credentials empty and authorize your computer’s IP in the member area. Private dedicated proxies can use either IP authorization or username and password.

Which Storm plan should I buy for Screaming Frog?

For text-only crawls, the 40-thread rotating plan lets you run about 30 crawl threads. For JavaScript rendering, budget about 10 plan threads per rendering thread, so the 80- or 150-thread plan. The 10-thread package is for testing the setup.

Do I need to restart Screaming Frog after changing the proxy?

Yes. Proxy changes only take effect after you close and reopen the SEO Spider.

Can I use a SOCKS proxy in Screaming Frog with Storm?

No. Storm gateways are HTTP(S) proxies only, and that’s what you enter in the proxy settings.

Still have questions? Contact us here. A real person answers.

Related guides

Tool facts checked against the official documentation (October 2026): SEO Spider user guide: Configuration (Proxy, Speed, Rendering) · SEO Spider FAQ · SEO Spider version 19.0 release (unified settings). Storm Proxies facts: our plans page and refund policy.

Unlimited bandwidth. One flat monthly price.

Access is live the moment you pay, and the smallest package of each proxy type has a 24-hour money-back guarantee on your first order.