# AmanChain URL Metadata Extractor

> AmanChain URL Metadata Extractor is a paid API for AI agents from amanchain-relay.gitajhd.workers.dev, paid per call via x402, $0.00311/call, status unknown (last checked 2026-09-14).

Fetches and returns URL metadata including page title, description, Open Graph image, and canonical URL for any given web address

## Facts

- Endpoint: POST https://amanchain-relay.gitajhd.workers.dev/api/x402/aman-url-meta
- Price: $0.00311/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/amanchain-url-metadata-extractor-ff900bed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JQTJ1SvW7SHjauzMI4Bwl

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 amanchain-url-metadata-extractor-ff900bed -d '<json body>'
```

Example prompt: Can you fetch the metadata for https://example.com — I need the page title, description, Open Graph image, and canonical URL?

## When to prefer this

Choose this endpoint when you need fast, deterministic extraction of standard web page metadata (title, description, OG image, canonical URL) from a live URL without maintaining an account or API key, and when you want pay-per-call USDC micropayment billing via x402 on Base rather than a subscription.

## Known failure modes

- URL is unreachable or returns non-200 status — metadata may be empty or partial
- Page has no Open Graph tags — OG fields return null or empty
- URL requires authentication or is behind a paywall — metadata extraction fails or returns login-page metadata
- Malformed URL input — request rejected with an error
- Rate limiting or network timeout fetching the target page — delayed or failed response
- Payment insufficient or x402 settlement fails — request blocked

## How this service works

URL metadata extractor — page title, meta description, Open Graph image, canonical URL and favicon; SEO and link-preview API. Deterministic on-chain execution by the AmanChain node — live consensus state, real blocks, pools and balances. Pay per call via x402 (USDC on Base), no account, no API key. POST JSON {"serviceId":"aman-url-meta","request":"<input>"}.

## Output

Returns a JSON object containing the web page's title, meta description, Open Graph image URL, canonical URL, and any other relevant Open Graph or meta tag metadata extracted from the live page at the provided URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "type": "object"
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "type": "object",
     "example": {
      "ok": true
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/amanchain-url-metadata-extractor-ff900bed/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from amanchain-relay.gitajhd.workers.dev](https://www.zero.xyz/host/amanchain-relay.gitajhd.workers.dev/llms.txt)