---
title: "Scrape"
method: POST
path: "/api/v1/scrape"
---

# Scrape

`POST /api/v1/scrape`

## Request

- Base URL: `https://api.mesharc.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mesharc.dev/api/v1/scrape`
- Auth: none declared

URLs in, their content out; no project.

One `url` waits for the page and returns it -- up to `timeout` seconds
(60 by default, 120 at most), then 202 with the id to poll, the fetch
carrying on either way. A list of `urls` is always 202: grouped by host,
small groups fanned out a task per URL, and either polled at
GET /scrape/{id} or announced by `webhook_url` (`scrape.completed`,
signed with the secret returned here once).

## Headers

- `authorization` string, nullable
- `x-mesharc-tenant` string, nullable

## Request body

- ScrapeRequest
  - `url` string, nullable
  - `urls` string[], nullable
  - `config` object, nullable
  - `webhook_url` string, nullable
  - `timeout` number, nullable
  - `formats` string, nullable
  - `maxCredits` integer, nullable
  - `destination` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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