---
title: "Screenshot a Web Page"
method: POST
path: "/v1/tools/screenshot"
---

# Screenshot a Web Page

`POST /v1/tools/screenshot`

## Request

- Base URL: `https://unstuckapi.com`
- URL: `https://unstuckapi.com/v1/tools/screenshot`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Take a screenshot of a website. Open any web page URL in a real browser and capture it as a PNG image, either the visible area or the full page. Use it to see what a site looks like, check a page layout, or capture visual proof of a web page.

Price: $0.01 per call. Charged once per call that returns a result, including an empty result list. Failed calls are free.

## Request body

- object
  - `url` string, required: The http(s) URL of the web page to capture.
  - `full_page` boolean: Capture the whole scrollable page instead of just the viewport (capped at 10000px tall).
  - `width` integer: Viewport width in pixels (default 1280).
  - `height` integer: Viewport height in pixels (default 800).

## Response `200`

Success

- object
  - `tool` 'screenshot', required
  - `result` object, required
    - `url` string, required: Link to the PNG, valid for 24 hours.
    - `expires_at` string, required: When the link expires (ISO 8601).
    - `final_url` string, required: Page URL after redirects.
    - `title` string, required: Page title.
    - `width` integer, required: Viewport width used, in pixels.
    - `bytes` integer, required: PNG size in bytes.
  - `charged_usd` number, required
  - `balance_usd` number, required

## Other responses

- `400`: Invalid JSON or input. Not charged.
- `401`: Paid tool without a valid API key.
- `402`: Balance too low for this call. Not charged.
- `404`: Unknown tool.
- `422`: The tool failed. Not charged.
- `429`: Rate limited, free tries used up, or the uncharged-result limit reached. See Retry-After.

---

[API](https://skmtc.dev/unstuckapi/apis/unstuck-api.md) · [All operations](https://skmtc.dev/unstuckapi/apis/unstuck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unstuckapi/apis/unstuck-api/revisions/ef3ec951224f?raw)