Skip to content
Gridlode
Docs · Reference

Screenshot

GET /v1/url/screenshot2 credits / requestcache 60 min

A screenshot of any public web page, rendered in real Chrome with JavaScript. Viewport or full page, JPEG or PNG, returned as a hosted image URL (kept 7 days) or inline base64. Respects robots.txt by default.

Query parameters

url
string · required
Public http(s) URL to capture.
full_page
boolean
Capture the whole page height (capped at 16,000 px).
Default: false
width
integer
Viewport width in pixels.
Default: 1280
height
integer
Viewport height in pixels.
Default: 800
format
string
Image format.
Default: "jpeg"
Allowed: jpeg, png
quality
integer
JPEG quality.
Default: 80
wait_ms
integer
Extra wait after load, for animations and lazy content.
Default: 1000
delivery
string
Hosted image URL (kept 7 days) or inline base64.
Default: "url"
Allowed: url, base64
respect_robots
boolean
Refuse URLs disallowed by the site's robots.txt.
Default: true
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/url/screenshot?url=https%3A%2F%2Fexample.com%2F&delivery=base64&width=800&height=600" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Screenshot API page.