---
search:
  tags:
    - Web
    - POST
seo:
  description: >-
    Fetch a URL and convert it to Markdown using webfold. The response is
    returned as plain… Reference for the POST /v1/web/scrape endpoint in the
    Webfold API.
sidebar:
  label: Scrape a web page
  badge: POST
title: Scrape a web page
type: openapi-operation
---
Fetch a URL and convert it to Markdown using `webfold`. The response is
returned as plain text Markdown, not JSON.

`POST /v1/web/scrape`

**Request body** (`application/json`, required)

- `url` (string<uri>, required)

Request body example:

```json
{
  "url": "https://example.com"
}
```

**Responses**

- `200` — Markdown content
- `400` — Bad request
- `401` — Missing or invalid bearer token
- `403` — Billing or plan entitlement blocked the request
- `502` — Upstream service (arXiv, YouTube, web page) failed

Response example, 200:

```json
"string"
```