{
  "id": "ruten",
  "displayName": "Ruten 露天拍賣 (Taiwan marketplace — listings)",
  "sourceId": "ruten",
  "sourceName": "Ruten (露天拍賣)",
  "sourceType": "marketplace",
  "sourceUrl": "https://www.ruten.com.tw",
  "module": "api/ruten",
  "enginePriority": ["api"],
  "categories": ["pokemon", "one_piece_card_game", "yugioh", "trading_cards", "rolex", "other_watches", "nike_jordan", "sneakers", "action_figures", "gundam", "nintendo_games", "designer_toys"],
  "regions": ["TW"],
  "country": "TW",
  "languages": ["zh"],
  "currency": ["TWD"],
  "supportsListings": true,
  "supportsSold": false,
  "supportsAuctions": false,
  "supportsImages": true,
  "supportsCatalog": false,
  "supportsPopulation": false,
  "supportsLookup": true,
  "refreshFrequencyMinutes": 360,
  "priority": "medium",
  "trustScore": 0.65,
  "attributionRequired": true,
  "termsUrl": "https://www.ruten.com.tw/help/policy.htm",
  "acquisitionMethod": "public JSON endpoints used by the site (search ids + item details), direct HTTP",
  "historicalDepth": "none",
  "accessNotes": "Two public, unauthenticated JSON endpoints that the ruten.com.tw front end itself calls, fetched with the honest RareIndexBot user agent: (1) `rtapi.ruten.com.tw/api/search/v3/index.php/core/prod?q=<kw>&type=direct&sort=rnk/dc&offset=<n>&limit=30` returns TotalRows + item ids (robots.txt of rtapi: Allow / except /api/gsa/ and /api/feedback/); (2) `rapi.ruten.com.tw/api/items/v2/list?gno=<up to 30 ids>&level=simple` returns name, TWD price/range, stock status, aggregate sold count, watch count, post/update time, storefront name and image (no robots.txt served → no restriction). Only asking prices are stored (listings); `sold_num` is an undated aggregate kept in metadata, never emitted as a sale. Item HTML pages (`/item/show?`) are disallowed by robots.txt and are never fetched — they are only used as attribution URLs. Buyer/seller personal data is not read; the public storefront name is kept as `seller`. 2 s between requests, concurrency 1, 30 ids per detail call.",
  "enabled": true,
  "schemaVersion": "1.0",
  "requires": [],
  "config": {
    "seeds": [
      { "q": "寶可夢 PSA10", "category": "pokemon", "language": null },
      { "q": "寶可夢 PTCG 中文版 SR", "category": "pokemon", "language": "Chinese" },
      { "q": "航海王卡 PSA", "category": "one_piece_card_game", "language": null },
      { "q": "遊戲王 PSA10", "category": "yugioh", "language": null },
      { "q": "勞力士 手錶", "category": "rolex", "language": null },
      { "q": "精工 GS 手錶", "category": "other_watches", "language": null },
      { "q": "Air Jordan 1 全新", "category": "nike_jordan", "language": null },
      { "q": "鋼彈 MG 未組", "category": "gundam", "language": null },
      { "q": "figma 全新", "category": "action_figures", "language": null },
      { "q": "BE@RBRICK 1000%", "category": "designer_toys", "language": null }
    ],
    "pagesPerSeed": 2,
    "sort": "rnk/dc",
    "defaultCategory": "trading_cards"
  }
}
