# MERCURY x402 Storefront API

**Canonical:** https://apis.io/apis/mercury-hq-com/mercury-x402-storefront-api/  
**Provider:** MERCURY — https://apis.io/providers/mercury-hq-com/  
**Base URL:** https://network.mercury-hq.com  
**Documentation:** https://network.mercury-hq.com/university/docs

MERCURY x402 Storefront API is one of 3 APIs that [MERCURY](https://apis.io/providers/mercury-hq-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include x402, Web Scraping, Data Extraction, Provenance, and Machine Payments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, pricing, and authentication docs.

REST/JSON API (OpenAPI 3.1.0, info.title "MERCURY x402 storefront", x-spec mercury-storefront/1) of 19 GET routes under /buy/*, one per Cited web-data service, each declaring its price in x-payment-info / x-x402 and answering an unpaid call with an HTTP 402 x402 challenge (accepts[] with scheme exact, network base, USDC asset 0x8335...2913, payTo and maxTimeoutSeconds 60). Paid results carry an attestation object (EIP-191 signature over sha256(text), url, status, fetchedAt, nonce) verifiable offline against /.well-known/mercury-attestation. /buy/signal is a free $0 demo read. The same routes accept Authorization: Bearer mk_test_/mk_live_ API keys issued at /developers. The spec declares no securitySchemes, no components and no examples; every operation has an operationId, summary, description, tags and 200/402 responses.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/buy/signal` | signal |
| GET | `/buy/fetch` | MERCURY Verifiable Web Fetch |
| GET | `/buy/extract` | Structured Data Extraction API — URL to typed JSON (schema extract, keyless x402) |
| GET | `/buy/markdown` | MERCURY Cited Markdown |
| GET | `/buy/metadata` | MERCURY Cited Metadata |
| GET | `/buy/links` | MERCURY Cited Links |
| GET | `/buy/robots` | AI Crawler Permission Audit — signed robots.txt / llms.txt / ai.txt verdict (keyless x402) |
| GET | `/buy/diff` | MERCURY Cited Diff — signed web-change proof (refetch + verifiable fromHash->toHash receipt) |
| GET | `/buy/notarize` | MERCURY Cited Notarize |
| GET | `/buy/headers` | MERCURY Cited Security-Headers Audit |
| GET | `/buy/table` | Cited Table — HTML table → typed JSON rows + CSV, with signed provenance (keyless x402) |
| GET | `/buy/feed` | MERCURY Cited Feed |
| GET | `/buy/availability` | MERCURY Cited Availability Probe |
| GET | `/buy/validate` | Cited Validate — JSON API response vs JSON Schema, signed pass/fail + per-field errors (keyless x402) |
| GET | `/buy/batch` | MERCURY Cited Batch — signed multi-page snapshot (Merkle root over every page's contentHash + per-page proofs) |
| GET | `/buy/sitemap` | MERCURY Cited Sitemap |
| GET | `/buy/dns` | MERCURY Cited DNS Snapshot |
| GET | `/buy/readability` | MERCURY Cited Readability |
| GET | `/buy/redirect` | MERCURY Cited Redirect |

## Machine-readable artifacts (20)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/openapi/mercury-hq-com-x402-storefront-openapi.yml
- **OpenAPI** — https://network.mercury-hq.com/openapi.json
- **Documentation** — https://network.mercury-hq.com/university
- **APIReference** — https://network.mercury-hq.com/university/docs
- **GettingStarted** — https://network.mercury-hq.com/university/developers
- **DeveloperPortal** — https://network.mercury-hq.com/developers
- **Pricing** — https://network.mercury-hq.com/pricing
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/overlays/mercury-hq-com-x402-storefront-overlay.yaml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/authentication/mercury-hq-com-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/conventions/mercury-hq-com-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/errors/mercury-hq-com-problem-types.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/lifecycle/mercury-hq-com-lifecycle.yml
- **Plans** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/plans/mercury-hq-com-plans-pricing.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/rate-limits/mercury-hq-com-rate-limits.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/sandbox/mercury-hq-com-sandbox.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/data-model/mercury-hq-com-data-model.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/conformance/mercury-hq-com-conformance.yml
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/skills/_index.yml
- **AgenticAccess** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/agentic-access/mercury-hq-com-agentic-access.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/mercury-hq-com/refs/heads/main/apis.yml

## Other MERCURY APIs (2)

- [MERCURY Web Fetch A2A Agent](https://apis.io/apis/mercury-hq-com/mercury-web-fetch-a2a-agent/)
- [MERCURY MCP Server](https://apis.io/apis/mercury-hq-com/mercury-mcp-server/)

## Tags

x402, Web Scraping, Data Extraction, Provenance, Machine Payments, Web Data

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/mercury-hq-com/mercury-x402-storefront-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/mercury-hq-com/.