Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
FREEDOM251

Freedom251 › Blog › Browshot

How to Set Viewport Size in Browshot—and What to Know About Device Scale Factor

By Freedom251 Team · · 2 min read

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

For a desktop Browshot capture, set the browser-window dimensions with screen_width and screen_height in the screenshot request. Browshot’s API documentation does not list a request parameter for setting device scale factor: its scale field is returned screenshot information, not a documented input. Browshot API documentation

Set the desktop browser-window dimensions

Include screen_width and screen_height in the request to Browshot’s screenshot-create endpoint, along with the required target url and instance_id. The documentation identifies these dimensions as desktop-browser parameters.

As an Amazon Associate I earn from qualifying purchases.

Parameter What it sets Documented range
screen_width Desktop browser-window width 1–5000 pixels
screen_height Desktop browser-window height 1–10000 pixels

For example, to request a desktop browser window 1440 pixels wide and 900 pixels high, pass screen_width=1440 and screen_height=900. These are documented window dimensions; the documentation excerpt does not establish that the resulting image dimensions always equal CSS viewport dimensions.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Device scale factor: what Browshot documents

The reviewed request-parameter list does not document a caller-controlled device scale factor. Browshot documents scale as returned screenshot information: it is always 1 for desktop browsers, while mobile instances may adjust it to fit the page on screen. Do not treat that returned value as an input for changing a desktop capture’s device scale factor.

#1 Best Overall
Sale
OneTouch Verio Test Kit with Meter, Lancets, Lancing Device and Test Strips
  • Complete Blood Sugar Kit: The OneTouch Verio kit is a compact blood sugar testing kit with the Verio Reflect glucose meter, lancing device, lancets, and test strips
  • Quick, Clear Results: This blood glucose meter uses OneTouch Verio blood sugar test strips for results in about 5 seconds with a bright, clear display
  • Gentle Lancing System: The included OneTouch Delica Plus lancing device and sterile lancets use a small blood sample for everyday blood glucose monitoring
  • Smart Tracking: The Verio Reflect blood sugar monitor works with the OneTouch Reveal app on your mobile device as a connected blood glucose monitoring system with stored results
  • About LifeScan: With over 40 years of leadership in glucose management and diabetes care, LifeScan offers patient-centric, clinically proven solutions built on simplicity, accuracy, and trust

Choosing desktop or mobile capture

Use a desktop instance when you need to specify desktop browser-window dimensions through screen_width and screen_height. Mobile instances follow their own behavior; Browshot says their scale may change to fit the page. Its service pages describe desktop and mobile virtual-device capabilities and screen resolution as a feature, but the cited documentation does not establish broader CSS viewport semantics or a way to set mobile device scale manually. Browshot service · Browshot features

Troubleshooting dimension and scale requests

  • Dimensions are rejected: Check that width is between 1 and 5000 pixels and height between 1 and 10000 pixels, and that you are using a desktop instance.
  • You cannot find a device-scale request parameter: The reviewed API parameter list does not document one. The documented scale value is returned information rather than a request setting.
  • The output does not appear to match a CSS viewport: Do not assume output-pixel dimensions and CSS viewport dimensions are equivalent. The cited documentation does not specify that relationship.
  • The page appears scaled on mobile: Browshot documents that mobile scale may change to fit the page. Its documentation excerpt does not describe a parameter to override that behavior.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup:

ScreenshotNeo can capture a URL with one GET request. Its API accepts a URL and returns a PNG, JPEG, WebP, or PDF; its documented options include viewport/device presets and retina scale. ScreenshotNeo · API documentation

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

ScreenshotNeo removes cookie banners, newsletter popups, and chat widgets before capture; bot checks, blank pages, and failed loads are never billed. Its MCP server lets AI agents take screenshots. The free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000. Sign up for ScreenshotNeo free.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

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.

Browshotdevice scale factorscreenshot APIviewport sizewebsite screenshots

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.