# Screenshot

> Render a public webpage as PNG, JPEG, or WebP with controls for the viewport, page readiness, and capture area.

Canonical URL: https://s1.dev/zh/docs/basic/screenshot

The success response is image binary data, not JSON. Save the response body to a file, return it from your own service, or create a browser object URL for preview.

Use `full_page` to capture the whole document, or `selector` to capture one visible element. These options cannot be enabled together.

Choose **Full-page PNG**, **Page element as WebP**, or **Dark-mode viewport** in the request example selector below. The cURL example writes the binary response to a correctly named image file; the official SDK examples return bytes plus the response content type and request ID.

The target must be a public HTTP or HTTPS URL without embedded credentials. Requests for private or special-use network addresses are rejected with `403 Forbidden`.

> **info:** A successful screenshot costs 2 credits. Failed requests are not charged.

Complete machine-readable schema: https://api.search1api.com/openapi.json