# red-web-utils Metadata Extractor

> red-web-utils Metadata Extractor is a paid API for AI agents from red-web-utils.agent-tools-x402.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-07).

Fetches metadata from a webpage URL, including title, description, Open Graph tags, JSON-LD, Twitter card, and canonical URL.

## Facts

- Endpoint: POST https://red-web-utils.agent-tools-x402.workers.dev/api/metadata?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-07
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/red-web-utils-metadata-extractor-2de90846
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hV9eV5N-M8m9FghjaLhbm

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 red-web-utils-metadata-extractor-2de90846 -d '<json body>'
```

Example prompt: Can you fetch the metadata from https://example.com — I need the title, description, Open Graph tags, and any JSON-LD structured data on the page?

## When to prefer this

Choose this endpoint when you need lightweight, structured metadata extraction from a single URL without full page scraping — ideal for link enrichment, social preview generation, SEO auditing, or structured-data inspection. It is pay-per-call with micro-pricing ($0.001 USDC), making it cost-effective for on-demand agent workflows. Prefer this over full crawlers when you only need head-level metadata, not page body content.

## Known failure modes

- URL is unreachable or returns a non-200 status — status field will reflect the HTTP error code
- Page has no Open Graph or JSON-LD metadata — those fields return empty objects or arrays
- JavaScript-rendered content not captured — only static HTML metadata is extracted
- Malformed or non-URL input causes a request failure
- Rate limiting or bot-blocking by the target site may result in empty or partial metadata

## How this service works

Pay-per-call web and onchain utilities for AI agents (MPP + x402, USDC on Base).

## Output

Returns a JSON object containing the page title, meta description, canonical URL, HTTP status code, Open Graph properties (og:title, og:image, og:description, etc.), Twitter card metadata, and any JSON-LD structured data arrays found on the page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://example.com",
  "title": "Example",
  "jsonLd": [],
  "status": 200,
  "twitter": {},
  "canonical": "https://example.com/",
  "openGraph": {
   "og:title": "Example"
  },
  "description": "Site description"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/red-web-utils-metadata-extractor-2de90846/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from red-web-utils.agent-tools-x402.workers.dev](https://www.zero.xyz/host/red-web-utils.agent-tools-x402.workers.dev/llms.txt)
