Skip to content
n8n workflowBy 8 min read

Screenshot a list of URLs in n8n

Thirteen or fourteen nodes, drawn below the way n8n draws them. Pick where the addresses come from, click a node to read its settings, then copy the file and paste it on your canvas.

The workflow

Where the addresses come from
Picture format

14 nodes. Pick one to read its settings.

Get the list

Ask for the picture

Where each row goes next: one of four exits of the node called Where next

  • ok

  • retry

  • stop

  • fail

After the second answer a row can only be ok, stop or fail, so it leaves the retry loop once. Pause leads back to Loop Over Items, which hands out the next row.

Capture

n8n-nodes-base.httpRequest · version 4.2

The HTTP Request node. One POST per row, with the address, the format and the options in a JSON body.

Three settings carry it. response_type json makes the API answer with a link, not a file. Response is set to include headers and status, with Never Error on, so a 429 arrives as an item with a status code. On Error continues, so a lost connection does not end the run. The node waits 90 s, which is the API timeout of 60 s plus 30.

Capture: parameters
{
  "method": "POST",
  "url": "https://curlshot.com/api/v1/screenshot",
  "authentication": "genericCredentialType",
  "genericAuthType": "httpHeaderAuth",
  "sendBody": true,
  "specifyBody": "json",
  "jsonBody": "={{ JSON.stringify({ url: $json.url, format: 'png', full_page: true, block_cookie_banners: true, timeout: 60, response_type: 'json' }) }}",
  "options": {
    "timeout": 90000,
    "response": {
      "response": {
        "fullResponse": true,
        "neverError": true,
        "responseFormat": "json"
      }
    }
  }
}
workflow.json: copy it, then paste it on the n8n canvas
{
  "name": "CurlShot screenshots from a list of URLs",
  "nodes": [
    {
      "parameters": {},
      "id": "n8n-shot-start",
      "name": "Start",
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        0,
        200
      ]
    },
    {
      "parameters": {
        "documentId": {
          "__rl": true,
          "mode": "id",
          "value": ""
        },
        "sheetName": {
          "__rl": true,
          "mode": "name",
          "value": "Sheet1"
        },
        "options": {}
      },
      "id": "n8n-shot-read-the-sheet",
      "name": "Read the sheet",
      "type": "n8n-nodes-base.googleSheets",
      "typeVersion": 4.7,
      "position": [
        220,
        200
      ]
    },
    {
      "parameters": {
        "mode": "runOnceForAllItems",
        "jsCode": "// Rows of the sheet that have a web address and no picture link yet.\nconst seen = new Set();\nconst rows = [];\nfor (const item of $input.all()) {\n  const url = String(item.json.url || '').trim();\n  if (!/^https?:\\/\\//i.test(url) || item.json.image_link || seen.has(url)) continue;\n  seen.add(url);\n  rows.push({ json: { url, row_number: item.json.row_number } });\n}\nreturn rows;"
      },
      "id": "n8n-shot-pick-new-rows",
      "name": "Pick new rows",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        440,
        200
      ]
    },
    {
      "parameters": {
        "batchSize": 1,
        "options": {}
      },
      "id": "n8n-shot-loop-over-items",
      "name": "Loop Over Items",
      "type": "n8n-nodes-base.splitInBatches",
      "typeVersion": 3,
      "position": [
        660,
        200
      ]
    },
    {
      "parameters": {
        "method": "POST",
        "url": "https://curlshot.com/api/v1/screenshot",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpHeaderAuth",
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={{ JSON.stringify({ url: $json.url, format: 'png', full_page: true, block_cookie_banners: true, timeout: 60, response_type: 'json' }) }}",
        "options": {
          "timeout": 90000,
          "response": {
            "response": {
              "fullResponse": true,
              "neverError": true,
              "responseFormat": "json"
            }
          }
        }
      },
      "id": "n8n-shot-capture",
      "name": "Capture",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        880,
        320
      ],
      "onError": "continueRegularOutput"
    },
    {
      "parameters": {
        "mode": "runOnceForEachItem",
        "jsCode": "// What the call answered, and where this row goes next.\nconst row = $('Loop Over Items').item.json;\nconst status = Number($json.statusCode) || 0;\nconst headers = $json.headers || {};\nconst body = $json.body && typeof $json.body === 'object' ? $json.body : {};\nconst mayRetry = true;\nlet route = 'fail';\nif (status === 200 && body.url) route = 'ok';\nelse if (status === 401 || status === 402 || status === 403) route = 'stop';\nelse if (mayRetry && (status === 0 || status === 429 || status >= 500)) route = 'retry';\nconst wait = Math.min(Math.max(Number(headers['retry-after']) || 0, 1), 60);\nconst code = body.error_code || (status === 200 ? 'no link in the answer' : '');\nreturn {\n  json: {\n    ...row,\n    route,\n    wait,\n    status: route === 'ok' ? 'ok' : status === 0 ? 'no answer' : ('HTTP ' + status + ' ' + code).trim(),\n    image_link: route === 'ok' ? body.url : '',\n    expires_at: body.expires_at || '',\n  },\n};"
      },
      "id": "n8n-shot-sort-the-answer",
      "name": "Sort the answer",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        1100,
        320
      ]
    },
    {
      "parameters": {
        "rules": {
          "values": [
            {
              "outputKey": "ok",
              "renameOutput": true,
              "conditions": {
                "options": {
                  "caseSensitive": true,
                  "leftValue": "",
                  "typeValidation": "strict"
                },
                "combinator": "and",
                "conditions": [
                  {
                    "id": "route-0",
                    "operator": {
                      "type": "string",
                      "operation": "equals"
                    },
                    "leftValue": "={{ $json.route }}",
                    "rightValue": "ok"
                  }
                ]
              }
            },
            {
              "outputKey": "retry",
              "renameOutput": true,
              "conditions": {
                "options": {
                  "caseSensitive": true,
                  "leftValue": "",
                  "typeValidation": "strict"
                },
                "combinator": "and",
                "conditions": [
                  {
                    "id": "route-1",
                    "operator": {
                      "type": "string",
                      "operation": "equals"
                    },
                    "leftValue": "={{ $json.route }}",
                    "rightValue": "retry"
                  }
                ]
              }
            },
            {
              "outputKey": "stop",
              "renameOutput": true,
              "conditions": {
                "options": {
                  "caseSensitive": true,
                  "leftValue": "",
                  "typeValidation": "strict"
                },
                "combinator": "and",
                "conditions": [
                  {
                    "id": "route-2",
                    "operator": {
                      "type": "string",
                      "operation": "equals"
                    },
                    "leftValue": "={{ $json.route }}",
                    "rightValue": "stop"
                  }
                ]
              }
            },
            {
              "outputKey": "fail",
              "renameOutput": true,
              "conditions": {
                "options": {
                  "caseSensitive": true,
                  "leftValue": "",
                  "typeValidation": "strict"
                },
                "combinator": "and",
                "conditions": [
                  {
                    "id": "route-3",
                    "operator": {
                      "type": "string",
                      "operation": "equals"
                    },
                    "leftValue": "={{ $json.route }}",
                    "rightValue": "fail"
                  }
                ]
              }
            }
          ]
        },
        "options": {}
      },
      "id": "n8n-shot-where-next",
      "name": "Where next",
      "type": "n8n-nodes-base.switch",
      "typeVersion": 3.2,
      "position": [
        1320,
        320
      ]
    },
    {
      "parameters": {
        "operation": "update",
        "documentId": {
          "__rl": true,
          "mode": "id",
          "value": ""
        },
        "sheetName": {
          "__rl": true,
          "mode": "name",
          "value": "Sheet1"
        },
        "columns": {
          "mappingMode": "defineBelow",
          "value": {
            "row_number": "={{ $json.row_number }}",
            "image_link": "={{ $json.image_link }}",
            "expires_at": "={{ $json.expires_at }}",
            "status": "ok"
          },
          "matchingColumns": [
            "row_number"
          ],
          "schema": []
        },
        "options": {}
      },
      "id": "n8n-shot-save-link",
      "name": "Save link",
      "type": "n8n-nodes-base.googleSheets",
      "typeVersion": 4.7,
      "position": [
        1560,
        120
      ]
    },
    {
      "parameters": {
        "amount": "={{ $json.wait }}",
        "unit": "seconds"
      },
      "id": "n8n-shot-wait-for-retry",
      "name": "Wait for retry",
      "type": "n8n-nodes-base.wait",
      "typeVersion": 1.1,
      "position": [
        1560,
        320
      ]
    },
    {
      "parameters": {
        "errorMessage": "={{ 'Stopped at ' + $json.url + ': ' + $json.status + '. Fix the key or the plan, then run again. Rows that already have a link are skipped.' }}"
      },
      "id": "n8n-shot-stop-and-report",
      "name": "Stop and report",
      "type": "n8n-nodes-base.stopAndError",
      "typeVersion": 1,
      "position": [
        1560,
        520
      ]
    },
    {
      "parameters": {
        "operation": "update",
        "documentId": {
          "__rl": true,
          "mode": "id",
          "value": ""
        },
        "sheetName": {
          "__rl": true,
          "mode": "name",
          "value": "Sheet1"
        },
        "columns": {
          "mappingMode": "defineBelow",
          "value": {
            "row_number": "={{ $json.row_number }}",
            "status": "={{ $json.status }}"
          },
          "matchingColumns": [
            "row_number"
          ],
          "schema": []
        },
        "options": {}
      },
      "id": "n8n-shot-save-error",
      "name": "Save error",
      "type": "n8n-nodes-base.googleSheets",
      "typeVersion": 4.7,
      "position": [
        1560,
        700
      ]
    },
    {
      "parameters": {
        "method": "POST",
        "url": "https://curlshot.com/api/v1/screenshot",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpHeaderAuth",
        "sendBody": true,
        "specifyBody": "json",
        "jsonBody": "={{ JSON.stringify({ url: $json.url, format: 'png', full_page: true, block_cookie_banners: true, timeout: 60, response_type: 'json' }) }}",
        "options": {
          "timeout": 90000,
          "response": {
            "response": {
              "fullResponse": true,
              "neverError": true,
              "responseFormat": "json"
            }
          }
        }
      },
      "id": "n8n-shot-capture-again",
      "name": "Capture again",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        1780,
        320
      ],
      "onError": "continueRegularOutput"
    },
    {
      "parameters": {
        "mode": "runOnceForEachItem",
        "jsCode": "// What the call answered, and where this row goes next.\nconst row = $('Loop Over Items').item.json;\nconst status = Number($json.statusCode) || 0;\nconst headers = $json.headers || {};\nconst body = $json.body && typeof $json.body === 'object' ? $json.body : {};\nconst mayRetry = false;\nlet route = 'fail';\nif (status === 200 && body.url) route = 'ok';\nelse if (status === 401 || status === 402 || status === 403) route = 'stop';\nelse if (mayRetry && (status === 0 || status === 429 || status >= 500)) route = 'retry';\nconst wait = Math.min(Math.max(Number(headers['retry-after']) || 0, 1), 60);\nconst code = body.error_code || (status === 200 ? 'no link in the answer' : '');\nreturn {\n  json: {\n    ...row,\n    route,\n    wait,\n    status: route === 'ok' ? 'ok' : status === 0 ? 'no answer' : ('HTTP ' + status + ' ' + code).trim(),\n    image_link: route === 'ok' ? body.url : '',\n    expires_at: body.expires_at || '',\n  },\n};"
      },
      "id": "n8n-shot-sort-the-second-answer",
      "name": "Sort the second answer",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        2000,
        320
      ]
    },
    {
      "parameters": {
        "amount": 1,
        "unit": "seconds"
      },
      "id": "n8n-shot-pause",
      "name": "Pause",
      "type": "n8n-nodes-base.wait",
      "typeVersion": 1.1,
      "position": [
        1780,
        120
      ]
    }
  ],
  "connections": {
    "Start": {
      "main": [
        [
          {
            "node": "Read the sheet",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Read the sheet": {
      "main": [
        [
          {
            "node": "Pick new rows",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Pick new rows": {
      "main": [
        [
          {
            "node": "Loop Over Items",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Loop Over Items": {
      "main": [
        [],
        [
          {
            "node": "Capture",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Capture": {
      "main": [
        [
          {
            "node": "Sort the answer",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Sort the answer": {
      "main": [
        [
          {
            "node": "Where next",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Where next": {
      "main": [
        [
          {
            "node": "Save link",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "Wait for retry",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "Stop and report",
            "type": "main",
            "index": 0
          }
        ],
        [
          {
            "node": "Save error",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Wait for retry": {
      "main": [
        [
          {
            "node": "Capture again",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Capture again": {
      "main": [
        [
          {
            "node": "Sort the second answer",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Sort the second answer": {
      "main": [
        [
          {
            "node": "Where next",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Save link": {
      "main": [
        [
          {
            "node": "Pause",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Save error": {
      "main": [
        [
          {
            "node": "Pause",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Pause": {
      "main": [
        [
          {
            "node": "Loop Over Items",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "pinData": {},
  "settings": {
    "executionOrder": "v1"
  },
  "active": false
}

The Google Sheets nodes, the credential and the real API were not part of the test (no Google account or access key on the lab host). What ran was the workflow file inside n8n against a stand-in server that played each answer. The webhook variant was imported but not triggered.

Set it up in five steps

  1. Make the sheet

    One tab with a header row: url, image_link, expires_at, status. Fill the url column with full addresses that start with http:// or https://. Leave the other three empty.

  2. Save the key as a credential

    In n8n, create a Header Auth credential with the name X-Access-Key and your access key as the value. The key never goes into the file.

  3. Paste the file on the canvas

    Copy the JSON above, click the empty n8n canvas and paste. n8n draws all the nodes and the lines between them.

  4. Pick the credential and the sheet

    Open Capture and Capture again and choose the credential. Open Read the sheet, Save link and Save error, sign in to Google, and choose the document and the tab.

  5. Run it

    Press Execute workflow. Each row that gets a link shows it in the image_link column. Run it again and the rows with a link are skipped.

The key stays in a credential

Never type the access key into a node or into the file you share. n8n stores a credential apart from the workflow, so the JSON you copy from this page carries no key. For the community node and its trigger, see the n8n page of the docs.

What it does with each answer

n8n has a Retry On Fail setting, and it is not enough here. Its wait is fixed at 5 seconds at most, it stops after 5 tries, and the HTTP Request node does not honour a Retry-After header [2]. So the node is set to hand every answer on as an item [1] and to continue after an error [5]. A Code node then sorts the answer, and Loop Over Items hands the rows out one at a time [4]. The codes and what to retry come from the errors page of the docs.

The answerRouteWhat the workflow doesWhy
200 and a link in the JSONokWrite the link, its expiry and status ok to the row.The call is a success and uses one screenshot.
200 and no linkfailWrite "HTTP 200 no link in the answer". No second call.Asking again will not add a link.
429retryWait the Retry-After seconds (at least 1, at most 60), call once more.You sent too fast. The docs say it passes after the wait.
500 and above (503 for a page that took too long)retryWait the Retry-After seconds, or 1 second without one, call once more.A temporary problem on our side or on the target site. The docs mark 500 and 503 as worth a second try.
No answer (the node timeout, a cut connection)retryWait 1 second, call once more.The call may not have reached the API, or the answer was lost.
401, 402, 403stopEnd the run with an error that names the address and the code.The key, the quota or the plan is the problem, and every later row would fail the same way. Failed calls are free.
400, 404, 413, 422 and the restfailWrite the status and the error code to the row. No second call.The request is wrong, so the same call fails the same way. Fix the address or the options.
429, a 5xx or no answer on the second callfailWrite the status. There is no third call.A bound on the loop, so a row can not spin forever. The row has no link, so the next run picks it up again.

The wait is the Retry-After value, held between 1 and 60 seconds. A wait under 65 seconds stays in memory, and a longer one is saved to the database [3].

What the run did

The file ran inside n8n 2.47.5 on 12 November 2026, against a stand-in server. 15 sheet rows went in. 3 were dropped before the loop (one had a link, one had no web address, one was a repeat), and 12 went through it. Each line shows the calls the server saw for one address, with the seconds until the next call.

  1. Answers 200 with a link.

    200

    LinkLink, expiry, status ok.

  2. The first call gets 429 with Retry-After: 2.

    4292.1 s →200

    LinkLink, expiry, status ok.

  3. The first call gets 429 with no Retry-After.

    4291.1 s →200

    LinkLink, expiry, status ok.

  4. Both calls get 429 with Retry-After: 1.

    4291.3 s →429

    No linkStatus: HTTP 429 rate_limited. No link.

  5. The first call gets 503 timeout, then 200.

    5031.1 s →200

    LinkLink, expiry, status ok.

  6. Both calls get 503.

    5031 s →503

    No linkStatus: HTTP 503 service_unavailable. No link.

  7. The first call hangs past the node timeout (3 s in the lab), the second answers 200.

    no answer4 s →200

    LinkLink, expiry, status ok.

  8. The connection is cut on both calls.

    cut1.1 s →cut

    No linkStatus: no answer. No link.

  9. Answers 422 invalid_options.

    422

    No linkStatus: HTTP 422 invalid_options. No link, and no second call.

  10. Answers 200, but the body is HTML.

    200 (not JSON)1 s →200 (not JSON)

    No linkStatus: no answer. n8n could not read the body as JSON, so the row looks like a lost connection.

  11. Answers 200 with JSON that has no link.

    200 (no link)

    No linkStatus: HTTP 200 no link in the answer. No second call.

  12. Answers 200 with a link.

    200

    LinkLink, expiry, status ok.

Result: 6 links and 6 status texts from 20 calls, in 38.6 seconds, of which about 11.8 were n8n starting up. The pause between rows is 1 second.

Two runs that end on purpose

Run stopped2 calls · 1 saved

The second of three rows answers 402 quota_exceeded.

The run ended with the error "Stopped at <address>: HTTP 402 quota_exceeded". The first row kept its link, the third address was never called.

Run stopped1 call · 0 saved

The first of two rows answers 401 access_key_invalid.

The run ended at once with the same kind of message, and the second row was never called.

The shapes of the nodes follow the n8n docs and files published as templates [7]. Besides these runs, all 12 variants of the generator (a sheet or a webhook, PNG, JPEG or WebP, with and without the pause) were imported into n8n without an error. The workflow file was generated by the function behind this page and imported into n8n 2.47.5 with its command line (import:workflow, then execute). Five nodes were swapped for the test: the sheet read, the two sheet writes (which posted their row to the stand-in server instead) and, on the two Capture nodes, the credential (a fixed header) and the timeout (3 s, so a hanging call could be shown). A script compared every other node with the generated file: they are identical. The stand-in server answered each address the way the errors page of the docs describes, with Retry-After on the 429s. Run one used 15 sheet rows, run two a 402, run three a 401.

What went wrong first

  • n8n refused the first file

    Importing the first generated file failed with "Workflow structure is invalid. nodes[11].position[1] (invalid_type): Expected number, received null". The generator had been called for Capture again without the API address, so every later argument moved one place. Reading the JSON had not shown it; the import did. Fixed, and all 12 variants of the generator (sheet or webhook, three formats, with or without the pause) now import.

  • Retry On Fail was the first plan

    The first plan was the setting every node has, Retry On Fail. The n8n docs say its wait is capped at 5 seconds, its tries at 5, and that the HTTP Request node does not honour a Retry-After header. A 429 that asks for 12 seconds would be tried again too soon. The file uses a Wait node that reads the header instead.[2]

  • A 200 that is not JSON reads as a lost connection

    With the response format set to JSON, an HTML body with status 200 made the node fail, so the row went down the "no answer" road and was called twice. It is a rare case, and the status text says "no answer", so look at the Executions list when a row says that and the site is up.

Where it still fails

  • The link in the sheet expires. The answer has an expires_at field and the workflow stores it. For a file that stays, add a step after Save link that downloads the link and uploads the file to Drive or S3.
  • Rows are taken one at a time. For hundreds of addresses a run takes as long as the sum of the renders; the bulk calls of the community node, up to 100 renders in one call, are faster.
  • The workflow leaves the cache off, so every run takes new pictures. Add cache true to the body if the pages change rarely; a cache hit is free.
  • A page behind a login needs an authorization or cookie option in the body. The workflow does not send one.
  • A row that fails stays without a link and is tried again at the next run. A page that always fails is tried every run, at no cost, until you fix or delete the row.
  • A list of 100 or more addresses is a job for one bulk call, and the bulk guide shows the order of work. A CI job that needs the same retry rules is in the GitHub Actions article.

Each row that gets a link uses one screenshot of your plan. Failed calls and cache hits are free. The Free plan has 100 screenshots a month and needs no card, Starter has 3,000. See the plans.

The webhook Pick new rows node expects a body like {"urls": ["https://example.com"]} [6].

Questions people ask

How do I screenshot a list of URLs from a Google Sheet in n8n?

Read the sheet with a Google Sheets node, loop over the rows one at a time, and send each address in a JSON body to the CurlShot screenshot endpoint with an HTTP Request node that has response_type json. Write the link in the answer back to the row with an Update row step. The workflow file on this page does all of it.

Does n8n retry a 429 on its own?

Only if you switch on Retry On Fail, and it does not read the Retry-After header: the wait is fixed, up to 5 seconds, and the tries are capped at 5 (n8n docs, read 2026-11-12). For a longer wait, use a Wait node, as this workflow does.

Can the list come from a webhook instead of a sheet?

Yes. Pick Webhook on the page and the file starts with a Webhook node that takes a POST body like {"urls": [...]}. It answers at once, and each result is appended as a row to the sheet. The webhook variant was imported into n8n in the test but not triggered.

How long does the link in the sheet last?

Until the expires_at time in the answer, which the workflow writes to the expires_at column. After that the link stops working. Download the picture, or add a Drive or S3 step, if you need it for longer.

Does this work on n8n Cloud?

Yes. It uses only nodes that ship with n8n: HTTP Request, Google Sheets, Code, Switch, Wait and Loop Over Items. The CurlShot community node does not run on n8n Cloud until n8n verifies it, so the workflow calls the API with the HTTP Request node instead.

What does a run of this workflow cost?

One screenshot of your plan for each row that gets a link. Failed calls cost nothing, so a retry that fails is free. The Free plan of CurlShot has 100 screenshots a month and needs no card.

Sources

  1. [1]n8n Docs, HTTP Request node: Response, Timeout and Header Auth options. Checked .
  2. [2]n8n Docs, Handle rate limits: Retry On Fail, Loop Over Items and Wait. Checked .
  3. [3]n8n Docs, Wait node: waits under 65 seconds keep the run in memory. Checked .
  4. [4]n8n Docs, Loop Over Items (Split in Batches): the loop and done outputs. Checked .
  5. [5]n8n Docs, Work with nodes: the On Error settings. Checked .
  6. [6]n8n Docs, Webhook node: Respond Immediately. Checked .
  7. [7]n8n, n8n workflow templates: how real files write the node JSON. Checked .

Screenshot any page in one step

Paste an address into CurlShot and download the screenshot. A free account gives you 100 screenshots every month. No card needed.