# Metadata
> Multi-vertical public metadata API for agents and apps (anime, manga, light novels, games, cartoons, comics, POD, TCG, figures, model kits, plush, board games, OST, consoles, esports).

Base: https://metadata.fyi (local: http://127.0.0.1:8787)
Header: X-Metadata-Vertical: {anime|manga|lightnovels|game|cartoons|comics|pod|tcg|figures|modelkits|plush|boardgames|ost|consoles|esports}
Also: host {vertical}.metadata.fyi or ?vertical=
Schemas: docs/SCHEMAS.md

## Start here (agents)
- /SKILL.md — when and how to call Metadata
- /llms-full.txt — full endpoint map
- /openapi.json — machine-readable route list
- /.well-known/ai-plugin.json — plugin-style discovery
- /v1/verticals — live verticals + counts
- /v1/health — liveness for active vertical

## Humans
- / — hub (vertical selector)
- /docs.html — playground
- /pricing.html — credit packs
- /stats.html — public platform traffic
- /legal.html — terms / privacy
- /feedback.html — flag bad data

## Core API
- GET /v1/search?q=
- GET /v1/series · /v1/series/{id} · /v1/characters/{id}
- GET /v1/products · /v1/print-methods (pod)
- GET /v1/tcg/cards · /v1/tcg/sets
- GET /v1/figures/items · /v1/modelkits/items · /v1/plush/items
- GET /v1/boardgames · /v1/ost/albums · /v1/consoles
- GET /v1/esports/titles|leagues|teams|players
- GET /v1/stats — platform metrics (no addresses)
- POST /feedback — corrections queue (not catalog write)
- POST /v1/contribute — suggest rows (queued)

## Auth & billing
- Free **preview** (teaser): limited per IP×vertical (default 8/24h) — not a free plan. GET /v1/preview
- Full catalog: prepaid credits + X-Wallet-Address (balance > 0). Plain reads do not debit per request; exports may.
- Discovery (health, verticals, preview, SKILL, pay, feedback) open without credits
- Pay: GET /v1/pay/quote · POST /v1/pay/claim · Stripe/Reown — see SKILL.md + docs/ACCESS.md
- x402: optional accept[] on 402 when X402_ENABLED — settlement still via claim/Stripe (not full x402 verify yet)

## Notes
- Public-internet metadata only; see /legal.html
- Flag errors via POST /feedback — do not invent silent fixes