---
title: "Scrape URL and convert to Markdown"
method: GET
path: "/web/scrape/markdown"
tags: ["Web Scraping"]
---

# Scrape URL and convert to Markdown

`GET /web/scrape/markdown`

Scrapes the given URL, converts the HTML content to Markdown, and returns the result.

## Query parameters

- `url` string, uri, required
- `includeLinks` boolean
- `includeImages` boolean
- `shortenBase64Images` boolean
- `useMainContentOnly` boolean

## Response `200`

Successful response

- object
  - `success` true, required — Indicates success
  - `markdown` string, required — Page content converted to GitHub Flavored Markdown
  - `url` string, required — The URL that was scraped

## Other responses

- `400` — Bad request - Invalid URL or failed to scrape
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Insufficient permissions or usage limit exceeded
- `408` — Request timeout
- `500` — Internal server error

## Changes

- **2026-03-28** `c91b0567307b` — 1 info
  - added the new optional `query` request parameter `useMainContentOnly`
- **2026-03-01** `584d3486a6c5` — 1 info
  - added the new optional `query` request parameter `shortenBase64Images`
- **2026-02-23** `2cdd67823c6a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/context/apis/brand-api/changes/web/scrape/markdown/get.md)

---

[API](https://skmtc.dev/context/apis/brand-api.md) · [All operations](https://skmtc.dev/context/apis/brand-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/context/brand-api/revisions/05a30711e18b/schema)