# Link Preview & URL Metadata

Turn a URL into a link preview: title, description, image, icon and site name from Open Graph, Twitter Card or plain HTML.

Send a URL and get its title, description, preview image, icon, site name and canonical address, read from Open Graph tags, Twitter Card tags and plain HTML in that order. Relative addresses come back absolute. No browser is run. We honour robots.txt and opt-outs, and ask each site slowly, so a page we may not read is refused and not charged.

- Open Graph, Twitter Card and plain HTML are read in that order, and relative addresses come back absolute.
- No browser is run, so answers are fast.
- We honour robots.txt and opt-outs; a page we may not read is refused and not charged.

## Calls

### `POST https://readymadeapi.com/v1/link-preview`

Fetch one public page and return its Open Graph, Twitter Card and HTML metadata as one tidy object.

- Price: $0.001 per link
- MCP tool: `link_preview_preview`
- Answers in the same call.

Request:

```json
{
  "url": "https://readymadeapi.com/samples/article.html"
}
```

Answer:

```json
{
  "canonical": "https://readymadeapi.com/samples/article.html",
  "description": "A starter needs flour, water and a routine. Here is the routine, and what to do when you forget it.",
  "icon": "https://readymadeapi.com/favicon.ico",
  "image": "https://readymadeapi.com/samples/product.jpg",
  "kind": "article",
  "lang": "en",
  "site_name": "The Sample Kitchen",
  "title": "How to keep sourdough starter alive",
  "url": "https://readymadeapi.com/samples/article.html"
}
```

## Limits

- One public page per call; pages that need JavaScript or a login are refused.

## Questions

**What is it for?**

Link cards in feeds, bookmarks and chat apps: unfurl a link the way Slack or iMessage does.

**Why was my URL refused?**

The site forbids automated reading of that page, or it needs JavaScript or a login. You are not charged.

**Why did I get a 429 site_busy?**

We ask each site slowly, across all our users. When a site has been asked too often you get an uncharged 429 with a Retry-After.

## Using it

- Send `Authorization: Bearer <key>` and a JSON body. Keys and credit: https://readymadeapi.com/account
- Every answer carries `X-Request-Id`, `X-Units` and `X-Charged-Usd`.
- An error is a JSON problem with a `title` to act on and a `detail` in plain words; nothing is charged for it.
- Full schema: https://readymadeapi.com/openapi.json
