# Minifetch URL Metadata Extractor

> Minifetch URL Metadata Extractor is a paid API for AI agents from minifetch.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Extracts rich structured metadata from a URL including Open Graph, Twitter cards, JSON-LD, headings, images, response headers, and more

## Facts

- Endpoint: GET https://minifetch.com/api/v1/x402/extract/url-metadata?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/minifetch-com-c6fd5c5e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_a3tA12x38IMLxFJm_akwe

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 minifetch-com-c6fd5c5e
```

Example prompt: Can you pull all the rich metadata from https://example.com — I want the full Open Graph tags, Twitter card info, JSON-LD, headings, images, and response headers? Use full verbosity so I get everything.

## When to prefer this

Choose this endpoint when you need the full breadth of structured metadata from a URL — especially Open Graph, Twitter cards, JSON-LD, headings, and HTTP headers all in one call. Prefer this over the light preview sibling endpoint when you need more than just title/description/image, and over the link extractor when your goal is page metadata rather than link inventory. Ideal for SEO auditing, metadata indexing, and content enrichment pipelines.

## Known failure modes

- URL is unreachable or returns non-2xx status — metadata may be empty or partial
- URL requires JavaScript rendering — static extractor may miss dynamically injected metadata
- Malformed or non-HTTP URL provided — returns validation error
- Target site blocks crawlers via robots.txt or firewall — request may time out or return 403
- No OG/JSON-LD tags present on page — corresponding fields will be empty in response

## How this service works

For technical SEO & metadata indexing: Extracts rich structured metadata from your URL (favicons, title, description, canonical, meta tags, Open Graph, Twitter Card, JSON-LD, redirects, headers, performance, headings, images). Returns everything by default; query params narrow response (pass atomic field names, ex: ?fields=title,description or named groups: network,meta,og,twitter). ?omitEmpty=true trims tokens for AI agents. Obeys robots.txt. Supports GET & POST

## Output

Returns an array of result objects containing comprehensive structured metadata from the requested URL: the original request URL, final resolved URL after redirects, HTTP response details, Open Graph tags, Twitter card tags, JSON-LD structured data, page headings, images, response headers, and optionally the full HTML body.

## Example request

```json
{
 "url": "https://example.com",
 "includeResponseBody": "false"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "The URL from which to extract metadata."
  },
  "includeResponseBody": {
   "type": "string",
   "description": "If set to true, includes the full HTML response body as a string in the result."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "results": {
   "type": "array",
   "description": "Metadata objects with requestUrl, url (final after redirects), and metadata (structured JSON with all extracted fields)"
  },
  "success": {
   "type": "boolean"
  },
  "queryParameters": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/minifetch-com-c6fd5c5e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from minifetch.com](https://www.zero.xyz/host/minifetch.com/llms.txt)