---
title: "URL screenshot"
method: POST
path: "/api/v1/render/url-screenshot"
tags: ["render"]
---

# URL screenshot

`POST /api/v1/render/url-screenshot`

## Request

- Base URL: `https://toolforte.com`
- URL: `https://toolforte.com/api/v1/render/url-screenshot`
- Auth: one of:
  - HTTP bearer
  - none

Take a PNG screenshot of a public web page with headless Chrome. Returns a hosted download URL valid for 24 hours. Same metering as the other render endpoints: 3 per day without a key, then 25 units per render from the shared monthly balance.

## Request body

- object
  - `url` string, required: Public http(s) URL
  - `width` integer
  - `fullPage` boolean

## Response `200`

Hosted PNG download URL

## Other responses

- `400`: Invalid or private URL
- `429`: Render limit reached
- `502`: Render failed

---

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