# ruten — Ruten 露天拍賣 (Taiwan)

TWD asking prices from Taiwan's largest C2C marketplace, via the two public JSON endpoints the site itself uses.

• rtapi.ruten.com.tw/api/search/v3/index.php/core/prod?q=<kw>&type=direct&sort=rnk/dc&offset=<n>&limit=30 → TotalRows + item ids (robots: Allow /).
• rapi.ruten.com.tw/api/items/v2/list?gno=<≤30 ids>&level=simple → name, TWD price / range, stock, aggregate sold_num (metadata only — never a sale), watch count, post time, storefront name, image.
• One raw record per search page (30 items) → listing records; identifiers.ruten_item_id; Chinese titles parsed for PSA grades, language (中文版 / 日文版), condition (全新 / 二手) and bundles (合售, 整套).
• Item HTML pages (/item/show?) are robots-disallowed → used only as attribution URLs; lookup() goes through the item JSON endpoint.
• Seeds: config.seeds = { q, category, language }, pagesPerSeed, resumable cursor { seedIndex, page }.

Smoke: pnpm tsx connectors/api/_g9-asia-watch-sneaker-lib/capture.ts ruten --limit 1 --seeds '勞力士 手錶'.