# 2s.io URL Unfurl

> 2s.io URL Unfurl is a paid API for AI agents from 2s.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Fetches a URL and extracts structured page metadata including title, description, Open Graph data, favicon, author, published time, and a body text preview.

## Facts

- Endpoint: GET https://2s.io/api/url/unfurl
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-c0acbacd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__OadCEO_1uNxIMtTXClZG

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-io-c0acbacd
```

Example prompt: Can you unfurl this URL for me — https://techcrunch.com/2024/01/15/openai-raises-funding/ — and tell me the page title, description, og:image, author, and published time?

## When to prefer this

Use this endpoint when you need to extract rich structured metadata from a single public URL — especially for link previews, content enrichment, article authorship/date extraction, or inspecting Open Graph and Twitter Card data. Prefer it over generic scrapers when you want clean, structured metadata fields rather than raw HTML, and when SSRF protection is important for security.

## Known failure modes

- URL resolves to a private/internal network address — blocked by SSRF guard with an error response
- Response body exceeds 512 KB limit — truncated or error returned
- Page takes longer than 8 seconds to respond — timeout error
- Invalid or malformed URL provided — validation error
- Page returns non-200 status — error reflected in response
- Page has no meta tags — empty fields returned with only body text preview

## How this service works

Fetch any URL and extract structured page metadata: title, description, og:image, canonical, favicon, site name, author, published time, language, and the first ~500 chars of body text. SSRF-guarded against private networks. 8s timeout, 512 KB max body. Returns the parsed metadata plus the raw og:/twitter:/itemprop meta dictionary for inspection.

## Output

Returns parsed page metadata including title, description, og:image URL, canonical URL, favicon URL, site name, author, published time, language, first ~500 characters of body text, and the full raw dictionary of og:/twitter:/itemprop meta tags found on the page.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "url": "https://www.wikipedia.org/"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "maxLength": 2048
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-c0acbacd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)