# Metadata — full agent index

## What it is
Open multi-vertical catalog API: series/characters (anime, manga, game, cartoons, comics, light novels),
POD blanks + print methods, TCG cards, figures/Nendoroids, model kits, plush, board games, soundtracks (OST),
consoles (hardware), esports (titles/leagues/teams/players).
MIT. Limited free preview (IP×vertical teaser), then prepaid USDG credits for full catalog.
Not a free plan. Discovery + pay + GET /v1/preview open. See docs/ACCESS.md · SKILL.md.

Canonical site: https://metadata.fyi
API / agent docs: https://metadata.fyi/SKILL.md · https://metadata.fyi/llms.txt

## Vertical selection
- Header X-Metadata-Vertical
- Subdomain {vertical}.metadata.fyi
- Query ?vertical=

### Live verticals
| id | primary resources |
|----|-------------------|
| anime | series, characters, seasons on series |
| manga | series, characters, volumes on series |
| lightnovels | series, characters, volumes |
| game | series, characters |
| cartoons | series, characters (western animation) |
| comics | western comics series + characters (not manga) |
| pod | products, brands, providers, print-methods, affiliates |
| tcg | games, sets, cards |
| figures | makers, lines, items |
| modelkits | makers, lines, items (Gunpla / plamo) |
| plush | makers, lines, items (fumo etc.) |
| boardgames | games, publishers |
| ost | albums, artists (linked to anime/game via seriesSlug) |
| consoles | hardware platforms (home/handheld/arcade) — NOT under game |
| esports | titles, leagues, teams, players |

## Endpoints (prefix /v1 recommended)

### Global
- GET /  — service index + docs map
- GET /v1/verticals
- GET /v1/health
- GET /v1/search?q=
- GET /v1/stats — public platform traffic
- GET /v1/affiliates?vertical=&configured=
- POST /feedback  (operator queue; same as /feedback.html — not catalog)
- POST /v1/contribute
- GET /v1/pay/packs  GET /v1/pay/balance  POST /v1/pay/claim
- GET /v1/export/character/{id}  (paid; charge after found)

### Media verticals
- GET /v1/series  GET /v1/series/{id}  GET /v1/series/{id}/characters  GET /v1/series/{id}/logos
- GET /v1/characters  GET /v1/characters/{id}
- GET /v1/logos?series=

### POD
- GET /v1/products  GET /v1/products/{id}
- GET /v1/brands  GET /v1/providers  GET /v1/print-methods

### TCG
- GET /v1/tcg/games  GET /v1/tcg/sets  GET /v1/tcg/cards  GET /v1/tcg/cards/{id}
- GET /v1/cards  (alias → tcg)

### Figures / model kits / plush
- GET /v1/figures/makers|lines|items  GET /v1/figures/items/{id}
- GET /v1/modelkits/makers|lines|items  GET /v1/modelkits/items/{id}
- GET /v1/plush/makers|lines|items  GET /v1/plush/items/{id}
- GET /v1/items  (alias → figures unless vertical=plush)

### Board games
- GET /v1/boardgames  GET /v1/boardgames/{id}
- GET /v1/publishers  GET /v1/publishers/{id}

### OST
- GET /v1/ost/albums?media=anime|game&series=&q=&type=
- GET /v1/ost/albums/{id}
- GET /v1/ost/artists  GET /v1/ost/artists/{id}

### Consoles
- GET /v1/consoles?formFactor=&generation=&manufacturer=&q=
- GET /v1/consoles/{id}
- GET /v1/manufacturers  GET /v1/manufacturers/{id}

### Esports
- GET /v1/esports/titles  GET /v1/esports/titles/{id}
- GET /v1/esports/leagues  GET /v1/esports/teams  GET /v1/esports/players

### Comics / cartoons / light novels
- Media series/characters routes with matching X-Metadata-Vertical

### Schemas
- docs/SCHEMAS.md — full TypeScript data shapes

## Data quality (not catalog API)
Human form: GET /feedback.html
Agent + form share: POST /feedback
  kind: correction|missing|spam|dmca|other
  vertical, entityKind, entityId, message (required)
  field, currentValue, suggestedValue, sources[], contributor, agent{name,url}
→ 202 { id, persisted: true, status: "queued" }
Legacy alias: POST /v1/report (deprecated)

## Agent files
- /SKILL.md
- /llms.txt
- /llms-full.txt
- /openapi.json
- /robots.txt
- /sitemap.xml
- /.well-known/ai-plugin.json