# Ambolt URL Metadata Extractor

> Ambolt URL Metadata Extractor is a paid API for AI agents from api.ambolt.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-11).

Fetches structured metadata (title, description, Open Graph, feeds, language, canonical URL, etc.) from one or up to 20 public HTTP(S) URLs in a single call.

## Facts

- Endpoint: GET https://api.ambolt.dev/v1/url-metadata?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ambolt-url-metadata-extractor-5c6001a0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CmfrQdxYptYNhZ6GxoW1o

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 ambolt-url-metadata-extractor-5c6001a0
```

Example prompt: Can you fetch the metadata for https://www.sitemaps.org/ — I need the page title, description, Open Graph tags, favicon, and canonical URL?

## When to prefer this

Choose this endpoint when you need structured web page metadata (title, description, OG tags, feeds, canonical URLs, language) from one or many URLs without running a full headless browser. It is especially useful for link preview generation, SEO audits, feed discovery, and enriching URLs with display metadata. Prefer it over generic scraping tools when you only need head/meta content rather than full page HTML or rendered DOM.

## Known failure modes

- URL is not publicly accessible or returns non-200 status — that URL appears in failed count with ok:false
- URL points to a non-HTML resource (PDF, image, etc.) — content type is reported but metadata fields may be empty
- Malformed or invalid URL in input — request may be rejected with a validation error
- Target page blocks crawlers via robots.txt or firewall — may return failed with no metadata
- Rate limit or payment failure — request rejected with 402 or 429 error
- Up to 20 URLs per call; exceeding maxItems causes schema validation failure

## How this service works

Pay-per-call data tools for developers and AI agents: company registers, documents, tenders, rates and on-chain facts as MCP tools, x402 endpoints and Apify Actors.

## Output

A JSON object containing a results array where each entry includes the final URL, HTTP status, page title, H1, meta description, Open Graph object, Twitter card object, favicon URL, canonical URL, language, hreflang tags, detected feeds, JSON-LD types, content type, theme color, robots meta, redirect flag, and generator. Also includes aggregate counts of succeeded, failed, and billableResults, plus a fetchedAt timestamp.

## 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": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "POST"
     ]
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "url": {
       "type": "string",
       "maxLength": 2000,
       "description": "One public http(s) URL. Use this or urls."
      },
      "urls": {
       "type": "string",
       "description": "Up to 20 public http(s) URLs; every page that returns metadata is one billable result."
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Metadata is the publisher's content; check its licence before reuse.",
  "failed": 0,
  "results": [
   {
    "h1": "sitemaps.org",
    "ok": true,
    "url": "https://www.sitemaps.org/",
    "feeds": [],
    "title": "sitemaps.org - Home",
    "status": 200,
    "favicon": "https://www.sitemaps.org/favicon.ico",
    "twitter": {},
    "finalUrl": "https://www.sitemaps.org/",
    "hreflang": [],
    "language": "en",
    "canonical": null,
    "generator": null,
    "openGraph": {},
    "redirected": false,
    "robotsMeta": null,
    "themeColor": null,
    "contentType": "text/html",
    "description": "The Sitemaps protocol enables webmasters to information earch engine about pages on their site that are available for crawling.",
    "jsonLdTypes": []
   }
  ],
  "fetchedAt": "2026-10-02T23:25:07.457Z",
  "succeeded": 1,
  "billableResults": 1
 }
}
```

## More

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