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.
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 plansBefore you start
- Log in to the member area and copy your gateway
IP:PORTs. They never change; the rotation happens on our side. - 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.
- 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.
- 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
- Quick reference: where every setting lives
- Thread math: crawl threads vs plan threads
- Why JavaScript rendering needs a bigger plan
- Rotating, residential or dedicated: which fits a crawler
- Crawling your own sites vs competitors, responsibly
- Common errors and fixes
- FAQ
Add a proxy to Screaming Frog, step by step
- 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.
- 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.
- 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. - 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”.
- 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.
- 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.
- 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.
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 SpiderConfiguration > 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
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.