Take screenshot

Last modified: April 15, 2022Author: Jakub Pomykała

This endpoint allows you to take a screenshot of any website. The screenshot image will be automatically uploaded to S3 bucket, and you will receive a link which could be used anywhere.

POST Endpoint

https://api.renderform.io/api/v1/screenshots

Example request

curl 
    --location 
    --request POST 'https://api.renderform.io/api/v1/screenshots' \
    --header 'X-API-KEY: <API_KEY>' \
    --header 'Content-Type: application/json' \
    --data-raw '{
        "url": "https://renderform.io"
        "width": 1366,
        "height": 768,
    }'

Request body

  • url (required) - website URL of which RenderForm should take a screenshot,
  • height (required) - screenshot height,
  • width (required) - screenshot width,
  • expires (optional) - add expiration time in seconds for the image, (1 to 604800),
  • waitTime (optional) - wait time in milliseconds before taking a screenshot (500 to 5000).

Example response

{
  "requestId": "ed39c85ac41f4c54b95e4caaad4ebff8",
  "href": "https://cdn.renderform.io/.../image.png",
  "request": {
    "width": 1366,
    "height": 768,
    "url": "https://renderform.io"
  }
}