Bulk screenshots from a CSV file.
Upload a list of URLs exported from Excel or any other system. Give every screenshot its own file name, add clicks, waits or scripts per row, preview the file paths, then send the whole list to your cloud storage.
- Up to 50,000 rows per file
- File name per row
- Straight to your storage
Download the template
Only url is required. Leave any other cell blank to use the defaults in step 3. In Excel, save your list with File → Save As → CSV UTF-8 (Comma delimited).
| Column | Description | Example |
|---|---|---|
url | The page to capture (required). | https://www.example.com/product/123 |
file | File name without the extension. Supports pattern variables such as {datetime}. | 3614274735277_{datetime} |
folder | Optional folder for this row (overrides the default folder). | products/{date} |
click | Elements to click before the capture, by text, #id or .class. Separate several clicks with |. | #accept|50ml |
wait | Delay in milliseconds after the page loads and clicks run. | 2000 |
script | JavaScript to run before the capture. | document.querySelector('.promo')?.remove(); |
Upload your CSV
Check the file names
Each row is saved with the name in its file cell. Rows with a blank file cell use the default file name below. Anything in {curly braces} is a variable that is filled in when the screenshot is taken.
| Row | URL | Saved as | Actions |
|---|
Dates and times are in UTC and use the moment each screenshot is taken (the preview uses the current time). For local time, use a timezone, e.g. {datetime_Asia/Kolkata}.
Choose where to save them
Screenshots are delivered straight to your storage. To save credentials once and reuse them, create a storage template.
Test, then submit
Send the first few rows as a test and check the results in your storage before submitting the full list. Test screenshots count toward your plan. Rows are sent in batches of 1,000 and captured in parallel.
Automate it with the API
This page sends the request below to the bulk API. Your own script or scheduler can send the same request, with up to 1,000 URLs per request.
POST https://api.addscreenshots.com/screenshots/bulk/multi?apikey=YOUR_API_KEY
{
"urls": [
{ "url": "https://www.example.com/product/3614274735277", "file": "3614274735277_{datetime}" },
{ "url": "https://www.example.com/product/3348901701969", "file": "3348901701969_50ml_{datetime}", "click": ["50ml"], "wait": 2000 }
],
"s3": "my-screenshots-bulk"
}Common questions
Can I upload an Excel file?
Save it as CSV first: in Excel, choose File → Save As → CSV UTF-8 (Comma delimited). Semicolon-separated files are also detected automatically.
How do I make every file name unique?
Use a value from your own data, such as a SKU, in the file column, and add {datetime} or {id}. The preview warns you when two rows resolve to the same name.
How do I know when the screenshots are finished?
Each screenshot is uploaded to your storage as soon as it's captured. Usage Logs in the dashboard show the status and any error for every screenshot.