October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk5 min

How to Generate Website Thumbnails in Bulk with ScreenshotMachine’s API

ScreenshotMachine documents a single-URL HTTP API, not a dedicated CLI or batch endpoint. Use Bash and curl to process a URL file locally and validate each thumbnail.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

ScreenshotMachine documents an HTTP GET screenshot API and a Bash curl example—not a distinct CLI program or a provider-side batch endpoint. To make thumbnails in bulk, save one URL per line and run a local shell loop that sends one API request per URL. For an Indian directory, use a consistent size such as the documented 320x240, then check each response and output file before importing it.

What “ScreenshotMachine CLI” means here

The documented command-line method is Bash plus curl calling ScreenshotMachine’s HTTP API. The documentation shows a request for one URL at a time; looping over a file of URLs is a practical local implementation, not evidence of an official CLI binary or batch API. Each URL therefore makes its own request. See the ScreenshotMachine API documentation for the provider’s request parameters and current details.

As an Amazon Associate I earn from qualifying purchases.

Prepare the directory’s URL list

Create a UTF-8 text file with one complete website URL per line, including https:// where available. Blank lines and lines beginning with # are skipped by the example below. Keep the source list separate from generated images so you can rerun the batch or investigate failures.

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

Before a large run, decide how the directory identifies a site and its image. A host-derived filename can collide when the input contains multiple paths or URLs that normalize to the same name. Redirects, query strings, internationalized domain names, and duplicate hosts also need an explicit policy. The sample’s filename cleanup is intentionally basic; use a stable unique ID or a collision-checked mapping in a production directory.

#1 Best Overall
Dell Optiplex 3060 Desktop Computer | Intel i5-8500 (3.2) | 32GB DDR4 RAM | 1TB SSD Solid State | Built in WiFi | Bluetooth | Windows 11 Professional | Home or Office PC (Renewed)
  • [INTEL POWERED CONTENT] - Built with a 8th Generation Hexa-Core Intel i5 and 32GB of DDR4 RAM; Modern, Windows 11 ready, with 4K support, Executive multitasking, media streaming and smooth, multi-tab web browsing; Perfect as an all-purpose multimedia computer; built for content creators; Plenty of RAM and Mass storage for photo and video editing powered by Intel HD 630
  • [LATEST WIRELESS TECH] - This Dell Desktop Computer easily connects to the internet through the Built In WiFi / Bluetooth
  • [SOLID STATE STORAGE] - This Dell Computer setup comes with an ultra-fast 1TB Solid State Drive (SSD); Setup as the primary boot device; Boot and load programs with lightning speed ; Additional expansion available
  • [BUY & OWN WITH CONFIDENCE] - From the world's largest Microsoft Authorized Refurbisher; Quality Guarantee and Free Tech Support; Award-winning Customer Service; | Support Sustainable Business
  • [MODERN HI-SPEED PORTS] - USB 3.0 (x4) | USB 2.0 (x4) | DisplayPort (x1) | HDMI Port (x1) | Audio Combo Jack (x1) | Audio Out (x1) | RJ-45 Ethernet (x1) | Internal SATA (x3)

Choose consistent thumbnail settings

Size and device

ScreenshotMachine explicitly gives 320x240 as a website-thumbnail dimension. Its documented width range is 100–1920 pixels and height range is 100–9999 pixels. Keep a single dimension across directory cards unless the layout needs another crop or aspect ratio. The documented device values are desktop, phone, and tablet; use a separate phone capture if the directory displays mobile previews. The documentation lists typical dimensions of 1024×768 for desktop and 480×800 for phone.

Format, delay, and cache freshness

The supported formats listed are JPG, PNG, and GIF, with JPG as the default. Choose one format for predictable imports; PNG may be more suitable where you need lossless output, while transparency requirements should be checked against the capture configuration.

Rank #2
Dell Optiplex 7050 SFF Desktop PC Intel i7-7700 4-Cores 3.60GHz 32GB DDR4 1TB SSD WiFi BT HDMI Duel Monitor Support Windows 11 Pro Excellent Condition(Renewed)
  • Model: Dell OptiPlex 7050 Small Form Factor (SFF)
  • Processor: Intel Core i7-7700 3.60 GHz
  • Memory: 32GB DDR4 Ram
  • Storage: 1TB Solid State Drive (SSD) Fast Boot + Storage
  • Operating System: Windows 11 Pro (64-bit)

The delay setting accepts values from 0 through 10000 milliseconds. The documentation advises a longer delay, such as 2000 ms or more, for long pages with images or animation, but waiting longer adds time to every request. The cacheLimit setting accepts 0 through 14 days and defaults to 14 days. Set it to 0 when each run should request a fresh capture; otherwise a cached image within the selected age may be reused.

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

Language and page behavior

The API documentation describes settings for accept-language, custom user agents, CSS selector capture, clicking, hiding elements, cookies, and cropping. These may help with localized pages or overlays, but choosing a language header does not establish that a screenshot is being rendered from an Indian geographic location. Test representative sites rather than assuming regional rendering behavior.

Rank #3
Sale
HP All-in-OneDesktop Computer, 16GB DDR5 RAM, Intel Quad-Cores, 128GB SSD, WiFi6, Keyboard & Mouse, Windows 11
  • IMMERSIVE 24 INCH DISPLAY: Experience stunning clarity on a Full HD IPS screen with ultra-thin bezels, offering a 90% screen-to-body ratio that makes everything from spreadsheets to streaming come alive with vibrant colors and crisp details.
  • POWERFUL INTEL PROCESSING: Tackle demanding tasks with ease thanks to the Intel processor and 16GB of high-speed memory, delivering smooth performance whether you're multitasking between applications or running productivity software.
  • GENEROUS STORAGE: Store all your important files, photos, and programs with blazing-fast solid state drive technology that ensures quick boot times, rapid file access, and plenty of space for your digital life.
  • ENHANCED PRIVACY AND COLLABORATION: Work confidently with the pop-up privacy camera that tucks away when not in use, plus dual microphones with noise reduction for crystal-clear video calls that keep you connected professionally.
  • ECO-CONSCIOUS DESIGN: Feel good about your purchase with an EPEAT Gold registered and ENERGY STAR certified computer that combines premium performance with responsible environmental manufacturing practices.

Run a local bulk capture loop

Save this as capture-thumbnails.sh. It follows ScreenshotMachine’s documented single-request Bash/curl pattern and repeats it locally for each URL. This is an editorial example, not a tested or official bulk script; confirm current account limits and add rate control suited to your run before processing a large directory.

#!/usr/bin/env bash
set -euo pipefail

: "${SCREENSHOTMACHINE_KEY:?Set SCREENSHOTMACHINE_KEY in the environment}"
input=${1:?Usage: ./capture-thumbnails.sh urls.txt output-directory}
outdir=${2:?Usage: ./capture-thumbnails.sh urls.txt output-directory}
mkdir -p "$outdir"

while IFS= read -r url || [[ -n "$url" ]]; do
  [[ -z "$url" || "$url" == \#* ]] && continue
  # Minimal host-derived naming; handle collisions and international names in production.
  name=$(printf '%s' "$url" | sed -E 's#^https?://##; s#[^A-Za-z0-9._-]+#_#g')
  curl --fail --silent --show-error --get 'https://api.screenshotmachine.com' 
    --data-urlencode "key=$SCREENSHOTMACHINE_KEY" 
    --data-urlencode "url=$url" 
    --data-urlencode 'dimension=320x240' 
    --data-urlencode 'device=desktop' 
    --data-urlencode 'format=jpg' 
    --data-urlencode 'cacheLimit=0' 
    --data-urlencode 'delay=1000' 
    --output "$outdir/$name.jpg"
done < "$input"

Provide the key through an environment variable and pass the input file and destination directory:

Rank #4
Dell Optiplex 3050 SFF Desktop Computer PC, Intel Quad Core i5-6500 up to 3.6GHz, 16GB DDR4, 256GB SSD, WiFi, 4K Support, DP, HDMI, Windows 11 Pro 64 Bit (Renewed)
  • This Certified Refurbished product is tested and certified to look and work like new. The refurbishing process includes functionality testing, basic cleaning, inspection, and repackaging. The product ships with all relevant accessories, a minimum 90-day warranty, and may arrive in a generic box. Only select sellers who maintain a high-performance bar may offer Certified Refurbished products on Amazon.com.
  • Dell Optiplex 3050 SFF Desktop computer PC, Intel Quad Core i5-6500 up to 3.6GHz, 16GB DDR4, 256GB SSD
  • Includes: USB Keyboard & Mouse, USB WiFi adapter, Microsoft office 30 days free trail.
  • Port: Front: USB 3.0(2), USB 2.0(2); Rear: DP, HDMI, USB 3.0(2), USB 2.0(2), RJ-45.
  • Support 4K (3840x2160) Dual display, makes it easy to connect two monitors at the same time, and you can expand working Windows, mirror content, or expand a single window across multiple monitors.
export SCREENSHOTMACHINE_KEY='YOUR_CUSTOMER_KEY'
chmod +x capture-thumbnails.sh
./capture-thumbnails.sh urls.txt thumbnails

The --data-urlencode options preserve URLs containing reserved characters. The sample uses delay=1000 as a modest wait; increase it selectively for pages that need longer to render. Its cacheLimit=0 requests fresh captures, which can be changed if reusing recent screenshots is acceptable.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Check outputs and handle failures

A successful-looking file is not enough to establish that it is a usable thumbnail. Inspect HTTP outcomes, the documented X-Screenshotmachine-Response header when available, file type, dimensions, and whether the image is blank or incomplete. For production runs, record each source URL, status or response code, output path, and retry result. Avoid treating every returned response as an image.

Best Value
Dell Windows 11 Desktop Computer OptiPlex 5060 | Intel Core i5-8500 Six Core (4.3GHz Turbo) | 16GB DDR4 RAM | 500GB SSD Solid State + 1TB HDD | WiFi + Bluetooth | Home or Office PC (Renewed)
  • Connectivity: Includes WiFi, Bluetooth, and LAN for wireless and wired connections
  • Memory: Features 16GB DDR4 RAM for smooth multitasking and performance
  • Storage: Combines 500GB SSD and 1TB HDD for ample storage space
  • Graphics: Integrated Intel UHD Graphics 630 for crisp visuals and video playback
  • Design: Sleek desktop tower with black color and slim profile for modern look

Common response codes

  • invalid_key: check that the key is correct and belongs to the account used for the request.
  • invalid_url or missing_url: confirm the input line contains a valid complete URL and that the encoded url parameter is present.
  • no_credits: check the account’s available credits before continuing the batch.
  • invalid_selector: if using selector capture, verify that the selector exists on the rendered page.
  • invalid_crop: review the crop coordinates and dimensions.
  • system_error: record the affected URL and response details; retry selectively rather than silently counting it as a completed thumbnail.

Credential protection

A customer API key is required and is obtained after signup. The documentation also describes an optional secret phrase and URL-derived MD5 hash; when a secret phrase is configured, a request without the correct hash is ignored. Keep both the key and secret phrase out of public client-side code, shared URL lists, and public repositories. The provider’s Python example recommends using the secret phrase for calls made from publicly available websites.

Or skip the browser setup

ScreenshotNeo is an alternative website screenshot API and MCP server. Its one-call API can return an image or PDF, and the parameters used by other screenshot APIs also work, which can make switching easier. Cookie banners are accepted and removed along with 60+ known consent platforms, newsletter popups, and chat widgets before the shot; each cleanup step can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits cost nothing, and the response identifies the page verdict and billing status in headers. Its MCP server gives AI agents tools to take screenshots, inspect page information, and capture PDFs.

For a thumbnail, use the API call below and change the target URL as needed. See the ScreenshotNeo API documentation for options and response details.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

The Free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000. Sign up for ScreenshotNeo’s free plan.

Frequently Asked Questions

Does the local loop create a ScreenshotMachine batch request?

No. It sends a separate HTTP GET request for each URL; provider-side batch processing is not established by the documented single-URL pattern.

Can I use an Indian-language page setting to guarantee an India-based screenshot?

No. The documentation describes an accept-language parameter, but does not establish that it selects an Indian capture location.

Quick Recap

Bestseller No. 2
Dell Optiplex 7050 SFF Desktop PC Intel i7-7700 4-Cores 3.60GHz 32GB DDR4 1TB SSD WiFi BT HDMI Duel Monitor Support Windows 11 Pro Excellent Condition(Renewed)
Dell Optiplex 7050 SFF Desktop PC Intel i7-7700 4-Cores 3.60GHz 32GB DDR4 1TB SSD WiFi BT HDMI Duel Monitor Support Windows 11 Pro Excellent Condition(Renewed)
Model: Dell OptiPlex 7050 Small Form Factor (SFF); Processor: Intel Core i7-7700 3.60 GHz; Memory: 32GB DDR4 Ram
$392.99
Bestseller No. 4
Dell Optiplex 3050 SFF Desktop Computer PC, Intel Quad Core i5-6500 up to 3.6GHz, 16GB DDR4, 256GB SSD, WiFi, 4K Support, DP, HDMI, Windows 11 Pro 64 Bit (Renewed)
Dell Optiplex 3050 SFF Desktop Computer PC, Intel Quad Core i5-6500 up to 3.6GHz, 16GB DDR4, 256GB SSD, WiFi, 4K Support, DP, HDMI, Windows 11 Pro 64 Bit (Renewed)
Includes: USB Keyboard & Mouse, USB WiFi adapter, Microsoft office 30 days free trail.; Port: Front: USB 3.0(2), USB 2.0(2); Rear: DP, HDMI, USB 3.0(2), USB 2.0(2), RJ-45.
$179.98
Bestseller No. 5
Dell Windows 11 Desktop Computer OptiPlex 5060 | Intel Core i5-8500 Six Core (4.3GHz Turbo) | 16GB DDR4 RAM | 500GB SSD Solid State + 1TB HDD | WiFi + Bluetooth | Home or Office PC (Renewed)
Dell Windows 11 Desktop Computer OptiPlex 5060 | Intel Core i5-8500 Six Core (4.3GHz Turbo) | 16GB DDR4 RAM | 500GB SSD Solid State + 1TB HDD | WiFi + Bluetooth | Home or Office PC (Renewed)
Connectivity: Includes WiFi, Bluetooth, and LAN for wireless and wired connections; Memory: Features 16GB DDR4 RAM for smooth multitasking and performance
$255.00

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.

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

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.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
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.