cited-metadata
metadata
json-ld
schema-org
open-graph
twitter-card
seo
social-card
structured-data
verifiable-data-record
provenance
attestation
keyless
agent-native
data-feed

MERCURY Cited Metadata

URL → one typed, SIGNED metadata record (JSON-LD + OpenGraph + Twitter-card + standard <meta> + canonical + title), by source. Deterministic, keyless, no LLM — the social-card/SEO/schema.org record an agent can PROVE.

get/buy/metadata

Request

Query parameters

urlstring required

the page to read metadata from (http/https)

Response

Delivered after the x402 payment settles on Base mainnet.

okboolean required

true on success; false on an honest failure (you are NOT charged for ok:false)

urlstring required

final URL after redirects

statusinteger

upstream HTTP status

fetchedAtstring

ISO-8601 time the page was read

textstring

the canonical signed string: JSON.stringify(data, sortedKeys). The attestation signs THIS.

errorstring

present only when ok:false

attestationobject

EIP-191 provenance receipt over sha256(text)+url+status+time, verifiable OFFLINE by anyone (key pinned at /.well-known/mercury-attestation). Proves THIS metadata record is exactly what MERCURY parsed from THIS url at THIS time — the wedge a free metadata API cannot emit.

Changes

No recorded changes to this operation across all 1 revision of this API.