# AgentFeed URL Unfurling

> AgentFeed URL Unfurling is a paid API for AI agents from agentfeed.up.railway.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Extracts metadata (title, description, image, favicon, Open Graph/Twitter card info) from a given URL

## Facts

- Endpoint: POST https://agentfeed.up.railway.app/api/v1/unfurl
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentfeed-url-unfurling-fea0b7cf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dixMx2pQ29b25oH55CT0s

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 agentfeed-url-unfurling-fea0b7cf -d '<json body>'
```

Example prompt: Can you unfurl this link and tell me the title, description, and preview image from https://openai.com/research/gpt-4?

## When to prefer this

Choose this endpoint when you need rich link preview metadata (title, description, OG image, favicon, Twitter card) from a URL without scraping the full page body. Ideal for building link unfurlers, content cards, or enriching URLs in feeds. Prefer over full content extraction when you only need surface-level metadata rather than full article text.

## Known failure modes

- URL is unreachable or returns non-200 status — metadata fields may be null or empty
- URL lacks Open Graph tags — title/description/image may fall back to inferred values or be null
- Payment not provided or insufficient — 402 Payment Required response
- Malformed URL input — validation error returned
- Dynamic/JS-rendered pages may not expose metadata to server-side fetch

## How this service works

Six payment-gated endpoints for AI agents: content extraction, price oracle, URL unfurling, web search, RSS parsing, and translation.

## Output

Returns a structured object containing the URL's title, description, domain, siteName, image URL, favicon URL, canonicalUrl, twitterCard type, and Open Graph type — everything needed to render a rich link preview.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "The URL to extract metadata from"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string"
  },
  "type": {
   "type": "string",
   "nullable": true
  },
  "image": {
   "type": "string",
   "nullable": true
  },
  "title": {
   "type": "string"
  },
  "domain": {
   "type": "string"
  },
  "favicon": {
   "type": "string",
   "nullable": true
  },
  "siteName": {
   "type": "string",
   "nullable": true
  },
  "description": {
   "type": "string"
  },
  "twitterCard": {
   "type": "string",
   "nullable": true
  },
  "canonicalUrl": {
   "type": "string",
   "nullable": true
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentfeed-url-unfurling-fea0b7cf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentfeed.up.railway.app](https://www.zero.xyz/host/agentfeed.up.railway.app/llms.txt)