---
title: "/fetch"
method: POST
path: "/v1/fetch"
tags: ["Fetch"]
---

# /fetch

`POST /v1/fetch`

The `/fetch` endpoint allows you to fetch a single webpage from a given URL.

## Request body

- FetchInput
  - `extractImages` union — Defines whether the API should extract the images from the webpage in its response.
    - boolean
    - string
  - `includeRawHtml` union — Defines whether the API should include the raw HTML of the webpage in its response.
    - boolean
    - string
  - `renderJs` union — Defines whether the API should render the JavaScript of the webpage.
    - boolean
    - string
  - `url` string, uri, required — The URL of the webpage you want to fetch.

## Response `200`

Successful response

- FetchOutputOutput
  - `images` FetchImageOutputOutput[] — List of images extracted from the webpage.
    - `alt` string, required — The alt text of the image.
    - `url` string, uri, required — The URL of the image.
  - `markdown` string, required — The clean markdown version of the webpage.
  - `rawHtml` string — The raw HTML version of the webpage.

## Other responses

- `400` — Bad Request - Invalid parameters
- `401` — Unauthorized - Invalid or missing API key
- `402` — Payment Required - No API key provided. Returns x402 payment details in the `payment-required` header for pay-per-request with USDC.
- `429` — Too Many Requests - Rate limit exceeded or insufficient credits

---

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