# Textdock URL Metadata

> Textdock URL Metadata is a paid API for AI agents from textdock.ggez.my.id, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-21).

Fetches and returns metadata for a given URL including HTTP status, page title, byte size, link count, and JSON-LD blocks.

## Facts

- Endpoint: POST https://textdock.ggez.my.id/url_metadata?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/textdock-url-metadata-d1f1aa11
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zYQA4CtgoH13rX_-W5lI3

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 textdock-url-metadata-d1f1aa11 -d '<json body>'
```

Example prompt: Can you fetch the metadata for https://openai.com/ — I want to know the page title, HTTP status, how many links are on it, and whether it has any JSON-LD structured data?

## When to prefer this

Choose this endpoint when you need lightweight, deterministic URL metadata — title, status, size, link count, and JSON-LD presence — without downloading or parsing the full page. It is ideal for link validation, building preview cards, detecting structured data availability, or checking redirect destinations. Prefer it over full scrapers when you don't need the raw HTML content and want a fast, low-cost per-call result billed in USDC.

## Known failure modes

- URL is unreachable or times out — HTTP status will reflect the error or response may indicate failure
- Invalid or malformed URL input — likely returns an error response
- Redirect loops — may fail to resolve final URL
- Pages requiring authentication — returns the login page metadata instead of the intended content
- Network-level blocks (e.g. bot protection) — may return 403 or redirect metadata

## How this service works

Deterministic CSV, URL and text utilities sold per call in USDC on Base.

## Output

Returns a JSON object with the resolved final URL, HTTP status code, page title, total byte size of the response, number of links found on the page, number of JSON-LD blocks, and the elapsed fetch time in milliseconds.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://example.com/",
  "bytes": 1256,
  "links": 1,
  "title": "Example Domain",
  "final_url": "https://example.com/",
  "elapsed_ms": 180,
  "http_status": 200,
  "jsonld_blocks": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/textdock-url-metadata-d1f1aa11/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from textdock.ggez.my.id](https://www.zero.xyz/host/textdock.ggez.my.id/llms.txt)