BomboAPI · Endpoints

50 routes · machine-readable at /api/v1/endpoints · spec at /openapi.json · player viewer

Player data 9

PathMethodHostAuthDescription
/data/:user GET both none Raw Hypixel SkyBlock profile export ({ign, profile, raw_profile, all_profiles}).
/player/:user GET api none Raw Hypixel player object.
/nw/:user GET both none Solo networth breakdown (skyhelper model).
/nwc/:user GET both none Co-op networth for every member.
/museum/:user GET both none Museum progress and donated items.
/inv/:user GET both none Decoded inventory and storage containers.
/shards/:user GET api none Attribute shard totals.
/name/:user GET both none Minecraft name history.
/playtime/:user GET both none Tracked playtime for a player.

Player viewer 5

PathMethodHostAuthDescription
/pv GET web none Viewer landing page (search + offline JSON dropzone).
/pv/:user[/:profile] GET web none Custom player viewer page (skills, dungeons, slayers, gear, networth).
/api/v1/pv/:user[/:profile] GET both none Structured profile model (model bombo-pv-v1). ?sections=core,gear,inventory,networth, ?refresh=1, ?download=1.
/oldpv/:user[/:profile] GET web none Legacy server-rendered viewer (pre-rebuild).
/oldpv POST web none Legacy snapshot render from an uploaded profile JSON.

Progression & planners 12

PathMethodHostAuthDescription
/api/v1/dungeons/class-average GET both none Runs-until-Class-Average planner (model adjectils-dungeon-v1).
/api/v1/dungeons/:player[/:profile] GET both none Per-player catacombs summary: levels, class average, floor PBs, secrets, RTCA50 plan (model dungeons-summary-v1).
/command/dungeons/:user GET both none Command surface: full dungeons/catacombs summary (aliases cata, dungeon, catacombs).
/command/rtca/:user GET both none Command surface: runs until Class Average 50 (aliases runs, runsleft).
/dungeons GET web none HTML class-average calculator.
/bestiary GET both none Bestiary mob criteria, islands and tiers.
/accessories/:user[/:profile] GET web none Accessory analysis page: coins-per-Magical-Power buy order, wiki-verified upgrade lines with recipe on click and item lore on hover, missing accessories, maximum-Magical-Power ceiling with tuning points, recombobulator and enrichment gaps, bag slot breakdown.
/accessories/user GET both optional Accessory analysis for the caller's own account (Authorization: Bearer <mod token>); falls back to ?user=<username>.
/api/accessories/:user[/:profile] GET api none Accessory analysis as JSON on the API host (same payload the page renders); ?format=json works on the web host too.
/accessories/map GET both none The accessory upgrade map itself, for auditing it: every line (Talisman of Coins -> Ring of Coins -> Artifact of Coins -> Relic of Coins), how each link was established, plus the Rift-exclusive and unobtainable sets. ?user=<ign> marks which rungs that account holds; ?format=json returns the map as data.
/calendar GET both none SkyBlock calendar events.
/election GET both none Active mayor / minister election.

Economy & market 6

PathMethodHostAuthDescription
/prices GET both none Auction-house item prices.
/prices2 GET both none Secondary price feed.
/bazaar GET both none Bazaar products and instant buy/sell.
/items GET both none Item catalog with NPC prices.
/bits GET both none Bits shop prices.
/hypixel/:endpoint GET both optional key Authenticated proxy to api.hypixel.net/v2/*.

Mod & client 7

PathMethodHostAuthDescription
/mod/latest GET both none Latest mod release metadata.
/mod/version GET both none Release catalog.
/mod/changelog GET both none Mod changelog.
/mod/bestiary GET both none Bestiary data for the client.
/mod/highlight GET both none Global highlight rules & aliases.
/mod/hoppity GET both none Hoppity egg data (POST/PUT Bearer-gated).
/resourcepack GET both none Texture pack repository & updates.

Auth & keys 3

PathMethodHostAuthDescription
/mod/auth POST api none Exchange a Mojang key pair for a Bombo bearer token (TTL 6h).
/mod/auth/status GET api none Auth service health (Mojang keys loaded, tokens issued).
/api/keys/player POST api none Create a player API key.

Player logs 3

PathMethodHostAuthDescription
/api/v1/profits POST api bearer Ingest dungeon/kuudra profit runs.
/profit/:user[/:type] GET both none Profit summary for a player.
/playtime POST api bearer Record playtime.

Meta & pages 5

PathMethodHostAuthDescription
/ GET api none API index (JSON).
/endpoints GET web none This endpoint catalog (HTML).
/api/v1/endpoints GET both none This endpoint catalog (JSON).
/openapi.json GET both none OpenAPI 3 specification.
/docs GET web none Interactive API reference.
Generated 2026-10-14T12:36:34.847Z. API base https://api.bombo.dpdns.org · web base https://bombo.dpdns.org