Halloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run ScanHalloween DealsAmazon USOctober picks are moving - compare before checkoutAmazon US: current deals, useful picks and tech finds.See Picks×
FREEDOM251

Freedom251 › Blog › screenshot API

How to Set the Viewport Size in a Thumbalizr Screenshot

By Freedom251 Team · · 4 min read

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

Set Thumbalizr’s browser viewport with bwidth and bheight, in pixels. The separate width parameter controls the output thumbnail’s width, not the browser viewport. Whether you can choose custom viewport dimensions depends on your account tier.

Set the browser viewport with bwidth and bheight

In a Thumbalizr Embed API request, add the desired viewport dimensions as query parameters. For example, bwidth=1440&bheight=900 asks for a 1440-by-900-pixel browser viewport, subject to your plan’s limits. The API documentation identifies url as the only required parameter; other settings can use the defaults in your account profile. See the Thumbalizr API documentation.

As an Amazon Associate I earn from qualifying purchases.

Encode the target page’s URL when constructing the request. Thumbalizr’s client examples encode the URL and options before building the request; this matters especially when the target URL itself contains query parameters or other reserved characters.

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

Example request parameters

  • url=https%3A%2F%2Fexample.com%2F: page to capture (URL-encoded).
  • bwidth=1440: browser viewport width in pixels.
  • bheight=900: browser viewport height in pixels.
  • width=800: optional output thumbnail width, independent of the viewport.
  • size=screen or size=page: capture the visible screen or the full page, where your tier supports the selected extent.

Use the API’s documented request and signing procedure for your account. Its signing examples derive an MD5 token from the query string and account secret. Keep that secret private: Thumbalizr warns that the older API is unsuitable for embedding on a public page if doing so exposes the API key, and recommends the current Embed API for embedding.

Know which dimensions your plan allows

The current API parameter table lists these browser dimensions by tier. The limits below are the values shown in Thumbalizr’s documentation; check its live documentation and plan pages before choosing an account or relying on a limit.

Tier Browser viewport width Browser viewport height Capture extent
Free Fixed at 1280 px Fixed at 1024 px screen only
Silver Fixed at 1280 px Fixed at 1024 px screen or page
Gold 1–1600 px 1–1600 px Screen or full page, per current feature descriptions
Platinum 1–2000 px 1–2000 px Screen or full page, per current feature descriptions

The API table gives a more specific Gold maximum than Thumbalizr’s demo page, which summarizes Gold and Platinum as supporting larger browser sizes up to 2000 pixels. For a Gold request, use the API table’s stated 1600-pixel limit unless current account documentation says otherwise. Tier descriptions and quotas can change; current plan details appear on Thumbalizr’s features and pricing page and demo page.

Rank #2
Free Fling File Transfer Software for Windows [PC Download]
  • Intuitive interface of a conventional FTP client
  • Easy and Reliable FTP Site Maintenance.
  • FTP Automation and Synchronization

Keep viewport size, output width, and page extent separate

  • Browser viewport: bwidth and bheight set the dimensions of the browser area used to render the page. These values can affect responsive layouts.
  • Thumbnail output width: width sets the width of the resulting thumbnail image. It does not change the browser viewport.
  • Capture extent: size=screen captures the visible screen; size=page requests a full-page capture, subject to tier availability.

For example, if you need the page to render at a 1440-pixel viewport but want a smaller image file, set bwidth=1440 and set width separately. Do not use width as a substitute for bwidth.

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

Confirm whether the capture completed

For API responses, inspect X-Thumbalizr-Status. The documented values include QUEUED, OK, and FAILED. A queued response is not the same as a completed screenshot; check the eventual response and any documented generation-time or error headers to determine the result.

Troubleshoot viewport requests

  • The page still renders at 1280×1024: Free and Silver are documented with fixed browser dimensions. Use a tier that permits custom dimensions if the account’s current limits allow them.
  • Your output image is narrower than the requested viewport: Check whether you set width. It controls the thumbnail’s output width; change bwidth and bheight to change the browser viewport.
  • A dimension is rejected or not applied: Verify the account tier and keep each requested value within its documented range. The current API table lists Gold up to 1600 and Platinum up to 2000 pixels in each dimension.
  • A full-page request does not produce a full-page capture: Check that you used size=page and that the plan supports full-page capture. Free is documented as screen-only.
  • The request fails or stays queued: Check X-Thumbalizr-Status and any error or generation-time headers. Ensure the target URL and request options are encoded correctly and that the API signing string was built according to the vendor’s documentation.
  • You are putting an API secret in browser-side code: Do not expose the secret on a public page. Follow Thumbalizr’s current Embed API guidance and keep signing credentials private.

Account for the ScreenshotCenter transition

Thumbalizr’s blog announced a transition to ScreenshotCenter and described expanded device emulation, including precise viewport and user-agent emulation, as planned for the coming months. That announcement does not establish that those capabilities are currently available in every Thumbalizr interface. Verify current product documentation before relying on them; see the Thumbalizr blog.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

For a one-call screenshot API alternative, ScreenshotNeo returns a PNG, JPEG, WebP, or PDF from a URL. Its API offers viewport and device options, while its cleanup steps can be turned off individually. The service accepts cookie/consent banners and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed as clean shots; responses identify the page verdict and billing status in headers. ScreenshotNeo also provides an MCP server with screenshot, page-info, and PDF tools for AI agents. The Free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 screenshots. See the 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

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

Sign up for ScreenshotNeo’s free plan: 1,000 screenshots a month, no card required.

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.

screenshot APIScreenshotNeoThumbalizrviewport 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
Windows Errors? Fix Them Before They SpreadFree repair scan
Outdated Drivers Are Slowing You DownFree scan - exact matches

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.