KOMEHYO

Search or browse KOMEHYO's live catalogue at ITEM level — every row is one specific second-hand object in stock, with KOMEHYO's own grade, the branch holding it, its tax-included price and, when it is reduced, the price before the reduction. Pass `query`, or any combination of `category` / `brand_no` / `condition` / `gender` / `price_band` / `discount` / `new_arrival` / `store` / `rare` / `vintage`, or nothing at all to walk all ~155,000 online items. `meta.total_results` is KOMEHYO's own exact count for the request, so a filter that bites and a filter that was ignored are told apart without guessing. 50 rows per page (KOMEHYO's own fixed size). Set `include_store_stock` to add the ~15,000 items that sit in a branch but are not sold online.

The complete record of ONE item by its `product_code`. Adds everything a search row cannot carry: KOMEHYO's own written definition of the grade this piece carries, its condition notes in KOMEHYO's own words (what is scuffed, blackened, scratched), the maker's model reference, the measured dimensions, the stones with carat / clarity / cut for jewellery, the material, colour and weight, what is in the box (including the appraisal or warranty certificate when there is one), the resizing range for a ring, the warranty period, the return policy, loyalty points, how many shoppers are watching it, every photo, KOMEHYO's own tags, its breadcrumb trail, and `attributes[]` — every label/value pair KOMEHYO printed, in order, verbatim, so nothing it publishes is lost to a mapping. A code that is no longer live answers NOT_FOUND (KOMEHYO returns a real 404, so this is never a guess). Prices are tax-included and cross-checked against two other numbers on KOMEHYO's own page.

KOMEHYO's own live category tree: 13 top-level categories, each with its slug, its numeric dispNo and KOMEHYO's own current item count, plus every subcategory underneath with its own slug and count (101 subcategories live on 2026-10-08). Takes the same scope parameters as `search`, so you can ask 'how does Louis Vuitton stock split across categories' in one call. This is how you get the exact `category` value to pass to `search` instead of guessing it.

Every brand KOMEHYO currently carries, with KOMEHYO's own brand id, its Japanese and latin names and how many items of it are in stock — 2,752 brands unscoped, or 96-128 inside one category. The `brand_no` returned here is the exact brand filter for `search`. Pass `category` to scope it (far cheaper: 240 KB instead of 2.9 MB) and `starts_with` to narrow it.

KOMEHYO's own live filter taxonomy with its own counts: every grade, gender, price band, sale bucket, new-arrival day, branch and the rare / vintage flags that actually have stock right now. Accepts the same scope parameters as `search`, so the counts are scoped — 'which grades exist inside Hermès bags', 'how much Rolex sits in Shibuya'. Use it to discover the exact filter value to pass rather than guessing it, and to read the grade ladder with KOMEHYO's own codes, labels and counts in one call.

KOMEHYO's 37 branches with its own branch id and how many of its online items each one is physically holding right now — Nagoya's main building, the Shinjuku and Shibuya stores, Ginza, Yokohama, Osaka Shinsaibashi, Fukuoka Tenjin and the rest. The `store_id` here is the exact branch filter for `search`, and the counts answer 'where is the stock' without 37 calls. Accepts the same scope parameters, so you can ask which branch holds the Rolexes.

KOMEHYO's own autocomplete: turn a half-typed word into the real search terms, brand slugs and categories KOMEHYO carries. One tiny request (under 450 bytes measured), meant to be called before `search` so a keyword lands on something real. ⚠️ KOMEHYO's own widget decorates these suggestions with counts generated by `Math.random()` in its front-end; those are not data and are not returned.