# xmr.club — JSON API summary

> Plain-text twin of https://www.xmr.club/api. Endpoints CORS-open, JSON unless noted, cached at the edge.

zh-TW: https://www.xmr.club/zh/llm/api.txt

## Read-only catalog

- GET https://www.xmr.club/api/v1/providers?category=&grade=&tag=&limit=&offset= — paginated provider listing
- GET https://www.xmr.club/api/v1/categories — all categories with active counts + intro
- GET https://www.xmr.club/api/v1/categories/<cat> — single category, full provider list
- GET https://www.xmr.club/api/v1/tags — every tag → provider count
- GET https://www.xmr.club/api/v1/search?q=&limit= — substring search across name/tagline/review
- GET https://www.xmr.club/api/v1/home — home-page snapshot ({stats, catCounts}, the SSR __INITIAL_DATA__ shape)
- GET https://www.xmr.club/api/v1/picks — editor's picks
- GET https://www.xmr.club/api/v1/onion — every provider with a .onion mirror
- GET https://www.xmr.club/api/v1/onion-audit — Onion-Location drift report
- GET https://www.xmr.club/api/v1/freshness?days= — listings beyond freshness threshold
- GET https://www.xmr.club/api/v1/changes?days= — recent provider audit entries grouped by action
- GET https://www.xmr.club/api/v1/audit?limit= — public audit log
- GET https://www.xmr.club/api/v1/stats — totals, by-grade, by-category, onions, picks, probe, sponsor counts
- GET https://www.xmr.club/api/v1/popular-asks?limit= — most-asked /ask queries
- GET https://www.xmr.club/api/v1/content-gaps?limit= — unmet /ask queries
- GET https://www.xmr.club/api/v1/extended-nodes — full /nodes set including uncurated

## Editorial surfaces

- GET https://www.xmr.club/api/v1/guides — every guide as JSON (slug, title, picks, twin URL)
- GET https://www.xmr.club/api/v1/guides/<slug> — single guide (intro, body_plain, body_html, picks)
- GET https://www.xmr.club/api/v1/glossary — taxonomy (grades, KYC posture, feature tags)
- GET https://www.xmr.club/api/v1/stack — curator's 12-pick reference kit
- GET https://www.xmr.club/api/v1/featured — current site-wide spotlight
- GET https://www.xmr.club/api/v1/random?cat= — random A-grade pick (no-store, fresh per request)

## Discovery

- GET https://www.xmr.club/api/v1/llm-surfaces — every AI-ingestion surface with sample URLs
- GET https://www.xmr.club/api/v1/health — bindings + cache + version

## Reviews ingest (write, bearer-auth)

- POST https://www.xmr.club/api/v1/review/verified — kyc.rip-only verified-review ingest

## Submit (public, rate-limited)

- POST https://www.xmr.club/api/submit — listing or correction submission

## Cache control (public, allowlist)

- POST https://www.xmr.club/api/cache/bust?path=... — purge allowed paths from edge cache

## Bulk data

- GET https://www.xmr.club/data.json — full dataset, CC-BY-4.0
- GET https://www.xmr.club/feed.xml — Atom of recently-verified
- GET https://www.xmr.club/feed.json — JSON Feed v1.1
- GET https://www.xmr.club/feed/audit.xml — Atom of curator actions
- GET https://www.xmr.club/feed/audit.json — JSON Feed of curator actions
- GET https://www.xmr.club/feed/<category>.xml — per-category Atom

## License

CC-BY-4.0 content. Code is the worker source.