# fittings URL Metadata Extractor

> fittings URL Metadata Extractor is a paid API for AI agents from fittings.sh, paid per call via x402, $0.003512/call, status unknown (last checked 2026-09-13).

Fetches a public URL and returns its title, description, preview image, site name, and canonical URL from HTML meta tags.

## Facts

- Endpoint: GET https://fittings.sh/v1/doc/url-metadata
- Price: $0.003512/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fittings-url-metadata-extractor-ea6f38af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RMibmVERAvn1tdjNEVFOx

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 fittings-url-metadata-extractor-ea6f38af
```

Example prompt: Can you pull the title, description, and preview image from this URL — https://www.vercel.com — so I can build a link preview card?

## When to prefer this

Choose this endpoint when you need lightweight link preview data (title, description, OG image, site name, canonical URL) from a URL without doing a full scrape. Ideal for generating link preview cards, enriching bookmarks, auditing SEO tags, or populating social share metadata. It is not suited for full page content extraction, structured scraping, or JavaScript-heavy SPAs that render meta tags client-side.

## Known failure modes

- URL is not publicly accessible (private, behind auth, or returning 4xx/5xx)
- Page has no meta tags or sparse metadata, resulting in empty/null fields
- Target URL redirects excessively or times out
- Non-HTML content-type (e.g. PDF, image) with no meta tags

## How this service works

Fetch a public URL and return its title, description, preview image, site name and canonical URL from its meta tags.

## Output

Returns the page's title, meta description, Open Graph or Twitter preview image URL, site name, and canonical URL as parsed from the HTML meta tags of the given public URL.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "description": "Public http(s) URL"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fittings-url-metadata-extractor-ea6f38af/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fittings.sh](https://www.zero.xyz/host/fittings.sh/llms.txt)