Scrape

Fetch a web page and extract its text content, links, images, and metadata including Open Graph tags.

POST /api/scrape

Parameters

Field	Type	Required	Description
url	string	Yes	URL to scrape

Response

Field	Type	Description
url	string	Fetched URL
title	string	Page title
description	string	Meta description
text	string	Extracted text content (max 50,000 characters)
links	array	Page links (max 100)
links[].href	string	Link URL
links[].text	string	Link text
images	array	Page images (max 50)
images[].src	string	Image URL
images[].alt	string	Alt text
meta	object	Meta tag key-value pairs
opengraph	object	Open Graph tag key-value pairs

Example

curl -X POST https://morso.dev/api/scrape \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

{
  "url": "https://example.com",
  "title": "Example Domain",
  "description": "",
  "text": "Example Domain\nThis domain is for use in illustrative examples in documents...",
  "links": [
    {"href": "https://www.iana.org/domains/example", "text": "More information..."}
  ],
  "images": [],
  "meta": {},
  "opengraph": {}
}

Errors

• 400 — Invalid URL, fetch failure, or HTML parse error.

See Errors for the standard error shape.