Screenshot a list of URLs at once
To screenshot many web pages at once, send the list to the CurlShot bulk endpoint: up to 100 requests in one call, each with its own options, on plans that include bulk. You get an answer at once with one job per page. The screenshots are made in the background, and you collect them with one status request for the whole batch or receive each one by webhook as it finishes.
curl "https://curlshot.com/api/v1/screenshot?access_key=YOUR_ACCESS_KEY&url=https://example.com&async=true&webhook_url=https://example.com/webhooks/screenshot" \
--output job.jsonHow to screenshot a list of URLs at once in three steps
- 1
Create an account on a plan that includes bulk, and copy your access key.
- 2
Send the list of addresses in one POST request to the bulk endpoint.
- 3
Follow the batch with one status request, or receive each result by webhook.
One call, up to 100 pages
A bulk call is a list of normal requests sent together. Each item has its own options and becomes its own job, so one page can fail while the others succeed. The answer comes at once, with the jobs in the same order as your list.
Show the table (2 rows)
| To collect the results | Use | Good when |
|---|---|---|
| One status request for the whole batch | The batch_url in the answer | A script that runs, waits and moves on |
| A webhook for every finished job | webhook_url for the call, or one per item | A server that should react as soon as each file is ready |
- Every option of a single request works inside an item, written as JSON: "full_page": true, not "true".
- Each successful render counts as one screenshot. Failed renders are not counted.
- A longer list goes in several calls of up to 100.
curl -X POST "https://curlshot.com/api/v1/bulk" \
-H "X-Access-Key: YOUR_ACCESS_KEY" \
-H "Content-Type: application/json" \
-d '{
"webhook_url": "https://your-app.example/hooks/screenshot",
"requests": [
{ "url": "https://example.com" },
{ "url": "https://en.wikipedia.org/wiki/Eiffel_Tower", "full_page": true, "format": "jpeg" },
{ "url": "https://news.ycombinator.com", "viewport_device": "iphone_15_pro" }
]
}'What people use it for
- Thumbnails for every site in a directory
- A screenshot of every page of a site before and after a redesign
- Nightly captures of a list of competitor or client pages
- PDF copies of a list of articles
For developers: one request
The same thing from your own code. It is a plain HTTP request, so it works from any language. Create a free account to get an access key.
Questions people ask
How do I take screenshots of multiple URLs at once?
Send them to the CurlShot bulk endpoint as one list. Each item is a normal request with its own address and options, and up to 100 fit in one call.
How do I get the results?
Ask for the status of the batch, which lists every job and a link to each finished file, or give a webhook address and each result is sent to it when it is ready.
What does the request on this page do?
It starts one screenshot in the background and sends the result to a webhook. A bulk call is a list of requests like it, started together.
How is a batch counted?
Like the same screenshots made one by one: each successful render is one screenshot. Failed renders are not counted. The pricing page shows which plans include bulk calls.
Guides that go deeper
- PlaybookHow to screenshot a list of URLs in bulkScreenshot hundreds or thousands of URLs: a queue simulator that says how long it takes, a short Node.js script, and what fails at scale.
- PlaybookWebsite change monitoring with screenshotsHow to get told when a web page changes: the capture and compare loop, three ways to detect a change, a noise checklist, a cron and Node.js setup, and tools.
- Pre-launch auditOne screenshot per template, not per pageCheck a site before launch with a few pictures, not thousands. Five real sitemaps grouped by page template, a sampler to paste yours into, and an audit sheet.
- EstimatorHow much storage do daily screenshots take?Measured sizes of 7 real pages as PNG, JPEG and WebP at 4 widths, plus an estimator: GB a month, a year and held, with and without dedupe.
- n8n workflowScreenshot a list of URLs in n8nAn importable n8n workflow: read URLs from a Google Sheet or a webhook, take each screenshot, write the link back. Retries 429, stops on 402.
Related tools
- Screenshot APIA screenshot API for developers. One HTTP request turns a URL, HTML or Markdown into a PNG, JPEG, WebP or PDF. Full page, devices, blocking, cache, MCP.
- Website thumbnailGenerate a website thumbnail from its URL: a small preview image of any page for directories, link lists, portfolios and newsletters. Free to try, by API too.
- Web page to PDFTurn a web page into a PDF document from its address. Real pages, working links and selectable text. Paste the address, nothing to install. Also an API.