Skip to content

Scrape & Screenshot API

Scrape

bash
POST /scrape

Extract page content with optional format conversion.

FieldTypeDefaultDescription
urlstring(required)Target URL
formatstring"text"text, html, or markdown
waitnumber2000Wait time in ms after load
profilestring"windows"Fingerprint profile
bash
curl -X POST http://127.0.0.1:9090/scrape \
  -H 'content-type: application/json' \
  -d '{
    "url": "https://example.com",
    "format": "markdown",
    "wait": 3000
  }'
json
{
  "url": "https://example.com",
  "content": "# Example Domain\n\nThis domain is for use in illustrative examples...",
  "format": "markdown",
  "status": 200
}

Screenshot

bash
POST /screenshot

Capture a screenshot of a page.

FieldTypeDefaultDescription
urlstring(required)Target URL
widthnumber1920Viewport width
heightnumber1080Viewport height
full_pagebooleanfalseCapture full scrollable page
formatstring"png"png or jpeg
profilestring"windows"Fingerprint profile
bash
curl -X POST http://127.0.0.1:9090/screenshot \
  -H 'content-type: application/json' \
  -d '{
    "url": "https://example.com",
    "width": 1280,
    "height": 720,
    "full_page": true
  }' --output screenshot.png

The response body is the raw image bytes with Content-Type: image/png.

bash
POST /navigate

Navigate to a URL without creating a session. Returns page metadata.

bash
curl -X POST http://127.0.0.1:9090/navigate \
  -H 'content-type: application/json' \
  -d '{"url": "https://example.com"}'
json
{
  "url": "https://example.com",
  "title": "Example Domain",
  "status": 200
}

Evaluate (Stateless)

bash
POST /evaluate

Execute JavaScript on a page without creating a session.

bash
curl -X POST http://127.0.0.1:9090/evaluate \
  -H 'content-type: application/json' \
  -d '{
    "url": "https://example.com",
    "script": "document.querySelectorAll(\"a\").length"
  }'
json
{
  "result": "1"
}

Released under the MIT License.