---
title: "Fetch a URL and convert its main content to Markdown."
method: GET
path: "/v1/read"
---

# Fetch a URL and convert its main content to Markdown.

`GET /v1/read`

## Request

- Base URL: `https://fetchgate.dev`
- URL: `https://fetchgate.dev/v1/read`
- Auth: none declared

## Query parameters

- `url` string, uri, required
- `format` 'json' | 'text'

## Response `200`

Successful extraction.

- object
  - `url` string, uri, required
  - `title` string
  - `markdown` string, required
  - `fetchedAt` string, date-time, required

## Other responses

- `400`: Invalid or disallowed URL.
- `402`: Free tier exhausted; payment required.
- `502`: Upstream fetch failed.

---

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