A 504 means a gateway or proxy did not receive a response from an upstream service in time. For a screenshot request, that upstream may be the screenshot provider, its browser renderer, the target website or one of the page’s dependencies—or a service on the network path. The status alone cannot tell you which one failed, so start by identifying the component that returned it.
What a 504 means in a screenshot workflow
HTTP 504 is a gateway-timeout response: a server acting as a gateway or proxy did not get a timely response from an upstream server. MDN’s 504 reference describes the status, but it does not identify the specific upstream or explain why that component was slow.
A screenshot request can cross several timing boundaries: your client’s timeout, an API gateway or proxy, the screenshot service’s application, its browser renderer, and the target page plus its external resources. The relevant deadline might be a provider-wide render limit, a browser navigation timeout, or an application/backend deadline. A 504 does not by itself prove that the target website is down.
Find which layer returned the timeout
- Capture the response details. Record the status, response body or error code, response headers, request ID, elapsed time, target URL, and rendering options. Do not infer the source from the status code alone.
- Compare elapsed time with documented limits. Check the specific provider’s navigation and overall render timeouts, along with any client or gateway deadlines you control. Providers differ in limits and in how they report renderer saturation, quota exhaustion, rate limiting, and page-render failures. For examples of provider-specific behavior, consult the Screenshot API documentation and the Screenshot API REST API reference.
- Run a controlled comparison. Retry the same target with the same options, then try a simple public page using the same API settings. If the simple page succeeds while the original fails, the target or its dependencies may be contributing to the delay. This is a diagnostic clue, not proof: provider-side or network problems can still affect individual requests.
- Check provider diagnostics. Review rate-limit and quota headers, account allowance, any request-status details, and provider guidance on failed renders. An API may distinguish a page failure from saturation, quota exhaustion, or throttling; those meanings are not universal.
- If you control the gateway or backend, follow the latency. Inspect gateway integration status and latency, backend processing time, resource availability, and network delays. AWS recommends enabling and checking API Gateway logs and examining integration status and latency; Microsoft lists backend processing time, resource exhaustion, and network delays among possible Azure Application Gateway causes. The applicable timeout settings depend on the named product and configuration. See AWS’s API Gateway 504 guidance and Microsoft’s Azure Application Gateway troubleshooting guide.
Adjust the page wait without losing needed content
Pages that depend on JavaScript, API calls, animations, or numerous external resources can take longer to reach a chosen wait condition. Waiting for all network activity to stop may be unnecessarily strict for a screenshot whose required content is already visible. Provider options vary, so use the conditions documented for your service.
Windows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallOutdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware match#1 Best Overall
- Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
- Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
- Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
- Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
- 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
- If the provider supports it, try an earlier navigation condition rather than waiting for all network activity to become idle.
- Where the screenshot needs a particular component, wait for a selector that marks that content instead of waiting for unrelated page activity.
- Avoid adding a long fixed delay unless the page genuinely needs it. Verify that the desired content has appeared before accepting a shorter wait.
Provider documentation illustrates different available controls: for example, Cloudflare’s screenshot endpoint documentation describes its request options, while RenderScreenshot’s troubleshooting documentation covers its own errors. These examples are not universal settings or limits; check the API and plan you actually use.
Should you increase the timeout?
Increase a deadline only when the operation legitimately needs more time and the relevant service permits it. A larger timeout may prevent a premature cutoff, but it does not make a slow backend, overloaded renderer, or delayed network path faster. AWS documents a possible timeout increase for some API Gateway REST API configurations while also recommending reducing runtime. Microsoft’s guidance likewise treats persistent 504s as potentially related to backend or network delays. Those are product-specific examples, not general screenshot API defaults.
Rank #2
- 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
- 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
- Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
- 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
- What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
Before changing a limit, identify which component enforces it and whether it is the first deadline reached. If a client gives up before the provider’s render deadline, increasing only the provider setting will not help. Conversely, a provider-side deadline cannot be extended by changing your local client timeout.
Retry only when a repeat request makes sense
A bounded retry can help with a transient network or provider issue, but repeated retries are not a diagnosis. Confirm that repeating the request is safe, follow the provider’s retry guidance, and honor a Retry-After header if supplied. Check whether failed renders count toward your quota before building automated retries. Stop retrying persistent failures and investigate the timing boundary instead.
Rank #3
- Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
- Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
- Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
- Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
- What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
What to send when escalating
Give the provider or site operator enough evidence to trace the request, but remove secrets before sharing.
- Request ID and timestamp, including timezone.
- Target URL and screenshot options, with cookies and authorization values redacted.
- Exact status, response body or error code, relevant headers, and elapsed time.
- Whether a simple comparison URL succeeded, and any gateway/backend latency or log evidence you control.
Do not send API keys, session cookies, or authorization headers in an unredacted support request. Provider support procedures differ; RenderScreenshot’s troubleshooting page is one example of documentation that requests request and response details.
Rank #4
- Dual Converters, Infinite Potential：Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
- Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
- Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
- Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
- Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
Or skip the browser setup
ScreenshotNeo is a website screenshot API and MCP server. It accepts a GET request with a URL and returns a PNG, JPEG, WebP, or PDF. Its response includes X-Page-Verdict and X-Billed headers, so you can check whether a request was billed and how the page was classified.
Here is a one-call cURL example. Replace the placeholder API key and target URL:
Best Value
- 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
- Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
- Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
- HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
- What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpSee the ScreenshotNeo API documentation for request details. Cookie and consent banners are accepted like a visitor, and more than 60 known consent platforms, newsletter popups, and chat widgets are removed before capture; each step can be turned off. Bot checks and CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed. An MCP server provides take_screenshot, get_page_info, and capture_pdf for AI agents and other MCP clients. The Free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 screenshots.
Sign up for ScreenshotNeo’s free plan to get 1,000 screenshots a month with no card.
Frequently Asked Questions
Does a 504 mean the target website is down?
No. It means a gateway or proxy did not get a timely upstream response; the status alone does not identify the upstream or establish that the target site is down.
Can I tell the source of the 504 from the status code alone?
No. Use the response body and headers, request ID, elapsed time, provider limits, and available gateway or backend telemetry to locate the timing boundary.
Recommended Free Tools
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
