# URL Metadata Fetcher

> URL Metadata Fetcher is a paid API for AI agents from api.qocgpiywhm.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-15).

Fetches page metadata from a URL including title, description, Open Graph tags, favicon, HTTP status, and content type; optionally returns main-content text.

## Facts

- Endpoint: POST https://api.qocgpiywhm.com/api/v1/tools/get_url_metadata?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/url-metadata-fetcher-84ed675b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0CxF91A6RUZ-zYlaVyNIX

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 url-metadata-fetcher-84ed675b -d '<json body>'
```

Example prompt: Can you grab the page title, meta description, Open Graph tags, and favicon for https://example.com so I can build a link preview card?

## When to prefer this

Use this endpoint when you need structured page metadata (title, description, Open Graph, favicon) from one or more URLs — especially for building link preview cards, auditing SEO meta tags, or enriching URLs with human-readable labels. Prefer this over the Web Content Cleaner (which extracts article body text) and over the Link Extractor (which lists outbound links). When you need to check just HTTP status and redirects without metadata, use the URL prober sibling instead.

## Known failure modes

- worker_chunk_failed: transient fetch failure for specific items — retry those items
- URL unreachable or returns non-2xx status — HTTP status reflected in result but metadata may be empty
- Malformed or non-HTML URL (e.g. PDF, binary) — content-type returned but metadata fields may be null
- Rate limiting or timeout on very slow pages — may return partial or empty metadata
- Invalid URL format — likely validation error or empty result

## How this service works

Use to fetch page metadata from a URL: title, description, Open Graph, favicon, HTTP status, and content type. Optional main-content text. One URL or items[]. Not article text (Web Content Cleaner) and not a link list (Link Extractor). If error is worker_chunk_failed, retry those items; the URL was not fetched. The HTTP body has correlation_id and data. The item array is data.results.

## Output

Returns a JSON object with a correlation_id and a data field containing results for each URL. Each result includes the page title, meta description, Open Graph properties (og:title, og:description, og:image, etc.), favicon URL, HTTP status code, content type, and optionally the main-content text. On transient worker_chunk_failed errors, specific items can be retried.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/url-metadata-fetcher-84ed675b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.qocgpiywhm.com](https://www.zero.xyz/host/api.qocgpiywhm.com/llms.txt)