# FetchWeb Metadata API

> FetchWeb Metadata API is a paid API for AI agents from fetchweb.net, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-13).

Returns lightweight page metadata — title, description, canonical URL, language, and estimated token count — for any given URL without full content extraction.

## Facts

- Endpoint: GET https://fetchweb.net/api/public/metadata?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fetchweb-metadata-api-9af8421e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DJl-hUuDtEGavg34QoNbP

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 fetchweb-metadata-api-9af8421e
```

Example prompt: Before I scrape the full article, can you do a cheap metadata check on https://example.com/article — just grab the title, description, language, and an estimate of how many tokens it would take to process?

## When to prefer this

Use this endpoint when you need to quickly triage or filter URLs before committing to more expensive full-page extraction. It is ideal for relevance checks, token budget estimation, deduplication via canonical URLs, and language filtering. Prefer it over full-extraction sibling endpoints when you don't yet need the page body, headings, or markdown — just the signals needed to decide whether deeper processing is worthwhile.

## Known failure modes

- URL is unreachable or returns a non-200 status — likely returns an error or empty fields
- Page has no meta description or title — fields may be empty strings
- Paywalled or bot-blocked pages may return incomplete or misleading metadata
- Language detection may be null for very short or binary pages
- Network timeout on slow-loading pages

## How this service works

FetchWeb provides pay-per-call web metadata for AI agents. Use FetchWeb to quickly inspect a URL — title, description, canonical URL, language and estimated token size — before performing web extraction, web research or LLM processing, so an agent can judge whether a page is relevant.

## Output

Returns a JSON object containing the page title, meta description, canonical URL, detected language (or null), word count, estimated token count, and a boolean indicating whether a charge was applied.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "Public http(s) URL."
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "lang": {
       "type": [
        "string",
        "null"
       ]
      },
      "title": {
       "type": "string"
      },
      "charged": {
       "type": "boolean"
      },
      "wordCount": {
       "type": "number"
      },
      "description": {
       "type": "string"
      },
      "canonicalUrl": {
       "type": "string"
      },
      "estimatedTokens": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fetchweb-metadata-api-9af8421e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fetchweb.net](https://www.zero.xyz/host/fetchweb.net/llms.txt)