# URL Metadata Extractor

> URL Metadata Extractor is a paid API for AI agents from utilsforagents.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-10, last successful call 2026-06-02).

Fetches a URL and extracts structured HTML metadata including Open Graph tags, Twitter Card tags, title, description, favicon, RSS feeds, and other meta tags.

## Facts

- Endpoint: POST https://utilsforagents.com/v1/url/metadata?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Last successful call: 2026-06-02
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/utilsforagents-com-75deec9e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_32tNkz3tdaVE0a8Lumk1C

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 utilsforagents-com-75deec9e -d '<json body>'
```

Example prompt: Can you pull the Open Graph title, description, og:image, and favicon for https://stripe.com so I can build a link preview card?

## When to prefer this

Use this endpoint when you need structured metadata from a URL without writing your own HTML parser. Ideal for building link preview cards, extracting Open Graph or Twitter Card data for social sharing, discovering RSS feeds, or enriching links with title/description/image data. Prefer this over full-page scraping endpoints when you only need metadata, not body content.

## Known failure modes

- Remote fetch timeout after 5 seconds if the target URL is slow to respond
- Response body exceeds 2 MB download limit, resulting in truncation or error
- Target URL returns a non-HTML content type (e.g. PDF, binary) with limited metadata
- Target URL is unreachable or returns a 4xx/5xx HTTP error
- Malformed or missing URL input returns a validation error

## How this service works

Pay-per-call AI agent utilities plus a free feedback endpoint: JSON diff, EXIF extraction, metadata scrubbing, HTML-to-Markdown, URL fetching, and feature-request collection. $0.003/call for paid utility routes via x402 on Base or Solana.

## Output

A structured JSON object containing the page's title, meta description, canonical URL, detected language, favicon URL, RSS/Atom feed links, Open Graph tags (og:title, og:image, og:type, og:description, og:url), Twitter Card tags, and additional meta tags like author, keywords, and robots directives.

## Example request

```json
{
 "url": "https://example.com"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "URL to extract metadata from (title, description, Open Graph, etc.)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "metadata": {
   "meta": {},
   "feeds": [],
   "title": "Example Domain",
   "favicon": "https://quotes.toscrape.com/favicon.ico",
   "language": "en",
   "canonical": "https://quotes.toscrape.com",
   "openGraph": {
    "type": "website",
    "title": "Example Domain"
   },
   "description": "This domain is for use in illustrative examples.",
   "twitterCard": {}
  },
  "sourceUrl": "https://quotes.toscrape.com",
  "processingTimeMs": 95
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/utilsforagents-com-75deec9e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from utilsforagents.com](https://www.zero.xyz/host/utilsforagents.com/llms.txt)