---
title: "URL → {html, links, metadata} in ONE render — 3 units"
method: POST
path: "/v1/web/scrape"
---

# URL → {html, links, metadata} in ONE render — 3 units

`POST /v1/web/scrape`

## Request

- Base URL: `https://api.preteworks.com`
- URL: `https://api.preteworks.com/v1/web/scrape`
- Auth: HTTP bearer

## Request body

- object
  - `url` string, uri, required: Public http/https URL.
  - `formats` string[]: Which representations to return (default: all).

## Response `200`

The requested representations.

- object
  - `url` string
  - `html` string
  - `links` string[]
  - `metadata` object

## Other responses

- `400`: Bad request.
- `401`: Missing/invalid API key.
- `402`: No billing profile, or monthly usage cap reached.
- `429`: Rate limited (60 req/min per key).
- `502`: Upstream fetch/render failed.
- `503`: Service at daily rendering capacity.

---

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