---
title: "Scrape Webpage"
method: POST
path: "/v1/scrape"
tags: ["Scrape"]
---

# Scrape Webpage

`POST /v1/scrape`

Scrape content from any URL. Returns text, HTML, markdown, links, or metadata. Supports pagination for multi-page crawls, custom proxies, and resource blocking.

## Request body

- ScrapeRequest
  - `url` string, uri, required — URL to scrape
  - `type` 'text' | 'html' | 'links' | 'markdown' | 'metadata' — Output format
  - `pages` integer — Number of paginated pages to scrape
  - `waitMs` integer — Wait time in ms after page load
  - `proxy` string — Custom proxy URL (http://user:pass@host:port)
  - `premiumProxy` boolean — Use managed residential proxy pool
  - `blockResources` boolean — Block images, media, and fonts
  - `locale` string — Browser locale (e.g. en-US)

## Response `200`

Content scraped successfully

- ScrapeResponse
  - `success` boolean
  - `results` object[]
    - `page` integer
    - `url` string
    - `data` string — Scraped content (string or JSON string for links/metadata)

## Other responses

- `400` — Validation error or invalid URL
- `401` — Invalid or missing API key
- `429` — Rate limit or quota exceeded
- `500` — Scrape failed (site unreachable or timeout)

---

[API](https://skmtc.net/snapapi/apis/snapapi-screenshot-web-data-api.md) · [All operations](https://skmtc.net/snapapi/apis/snapapi-screenshot-web-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/snapapi/snapapi-screenshot-web-data-api/versions/b12ff2791613/schema)