Skip to main content
Two endpoints turn a page into images instead of text. Images lists every image on a page with its details. Screenshot takes a picture of the page as a PNG. Both answer in the same call. Images costs 1 credit. A screenshot costs 5, because the page is always fully rendered.

Images

POST /v1/web/images lists every image on a page with its full address, alt text and declared size. Use it to collect product photos, build an image index, or find the biggest picture on a page.
string
required
The page to read. Must be http or https.
number
Use a recent copy of the page if it is younger than this many milliseconds. 0 always reads fresh. At most 7 days. See Caching.
Each image has src, made into a full address, and alt, width and height, each null when the page does not say.

Screenshot

POST /v1/web/screenshot renders a page and saves it as a PNG. You get back a public link to the image. Use it for visual snapshots, archives, or to show a page to a vision model. The picture shows the page a reader would see. Cookie banners are accepted, newsletter and anti-adblock pop-ups are closed, ads and trackers never load, and bot-check boxes are hidden, so the screenshot is not mostly a box asking if you are human. A page that is nothing but a challenge is left as it is, because a blank picture would look like success.

Options

string
required
The page to capture. Must be http or https.
boolean
default:"false"
Capture the whole scrollable page instead of only the first screen.
string
default:"desktop"
The screen size to render at: desktop (1920 by 1080), laptop, tablet or mobile.
number
An exact screen width in pixels, from 320 to 3840. Overrides viewport.
number
An exact screen height in pixels, from 240 to 2160. Overrides viewport. With fullPage, the picture still covers the whole page.
number
Extra milliseconds to let the page settle before the picture, up to 30000.
number
The time budget for the call in milliseconds, from 1000 to 100000.
number
Reuse a saved screenshot younger than this many milliseconds. The default is 7 days, so asking again for the same page and options returns the saved PNG at once with cached: true, without applying waitFor. Set 0 to take a new one.
boolean
default:"true"
Accept cookie and consent banners before the capture. Set false to capture them.
boolean
default:"true"
Clear popups and overlays covering the page before the capture. Set false to capture them.

Response fields

string
A public link to the PNG. It stays the same for the same URL and options.
string
fullPage or viewport.
number
The image size in pixels.
boolean
true when a saved screenshot was reused.
number
The HTTP status the page returned.

Cost

Failed calls are free. See Credits.

Scrape

Clean Markdown and structured data from a page.

Brand data

A company’s logos and colours, ready to use.

Caching

How maxAge reuses a recent copy.

API reference

The full schemas, with a live playground.