露天拍賣商品爬蟲｜搜尋、價格、二手行情追蹤（免 API、免登入）

一個 Actor 搞定露天拍賣（Ruten）兩種你會用到的抓取模式：關鍵字搜尋（拿商品列表、即時價格、銷售量）與商品詳情（依 ID/網址拿單一商品的完整資料）。不需要登入、不需要 API token，批量貼上上百個關鍵字或商品編號都吃得下。全程走露天官方 rtapi 半公開 JSON 端點，不開瀏覽器，速度快、成本低。

給誰用的：追蹤二手行情波動的、做比價 / 市場調查的、電商數據分析的、論文需要資料集的、自己寫 side project 的工程師。

---

能抓到什麼

每一筆商品都會拿到下面這些欄位（缺值一律回 null，不會少欄位）：

欄位	說明	範例
item_id	露天商品編號	21311212469710
title	商品名稱	羅技 M331 靜音無線滑鼠
price	售價下限（NT$）	269
price_range	價格範圍，有分級才會是區間	269 或 269-500
currency	幣別	TWD
condition	商品新舊狀況（v1.0 一律 null）	—
stock	庫存，即時值	12
sold_count	銷售數，累計成交件數	358
rating_count	評價數（v1.0 一律 null）	—
seller_id	賣家 ID	abc123seller
seller_name	賣家名稱（v1.0 一律 null）	—
seller_rating	賣家評等（v1.0 一律 null）	—
location	商品所在地（v1.0 一律 null）	—
shipping_options	運送方式（v1.0 一律空陣列 []）	—
image_urls	商品圖網址陣列	["https://gcs.rimg.com.tw/..."]
item_url	商品網址	https://www.ruten.com.tw/item/show?21311212469710
source_mode	這筆從哪個模式來的	search、item
source_query	抓取時用的查詢條件（關鍵字或商品編號）	羅技滑鼠
scraped_at	抓取當下時間（ISO 8601）	2026-07-04T05:23:28.617Z

這隻爬蟲的差異化在 sold_count（銷售數）、price_range（價格範圍）、stock（庫存）三個欄位——都是即時值，抓取當下的實際狀態，適合拿來做二手行情觀察（見下方「幾個要注意的地方」）。

重要：condition、rating_count、seller_name、seller_rating、location 在 v1.0 一律 null，shipping_options 一律空陣列 []。露天商品批次端點（rtapi prod v2）本身不回這些欄位；賣家詳細資料規劃在 v1.1 的「賣場模式」加入（見下）。

---

兩種模式一個爬蟲

模式	幹嘛用的	計費事件	單價
🔎 search	關鍵字搜尋，拿商品列表（含價格、庫存、銷售數）	search-listing（每筆）	$0.002
📦 item	依商品編號/網址抓單一商品的完整資料	product-detail（每筆）	$0.008

不管跑哪個模式，每次 Run 啟動都會額外收一次性的 actor-start 費用 $0.005。所有計費都在資料成功寫入 dataset 之後才會收，Run 結束時 log 會印出 total_items / charged / skipped 讓你對帳。

一次跑一個 mode，從 Apify Console 的下拉選單選就好。

賣場（seller）模式規劃於 v1.1，目前版本（v1.0）只支援 search 與 item 兩種模式，尚未支援依賣家帳號抓整間賣場的商品列表。

---

輸入欄位

欄位	型別	必填	預設	說明
mode	enum	建議填	search	search（關鍵字搜尋）/ item（商品詳情）擇一。
keywords	string[]	search 模式必填	—	搜尋關鍵字，一個概念一個關鍵字最準。單次最多 50 個。
itemIds	string[]	item 模式必填其一	—	露天商品編號，例如 21311212469710（在商品網址 /item/show? 後面那串數字）。單次最多 100 個。
itemUrls	string[]	item 模式必填其一	—	露天商品完整網址，例如 https://www.ruten.com.tw/item/show?21311212469710，會自動抽出編號。單次最多 100 個。
bulkInput	string	選填	—	一行一個，按 Enter 換行，不要加引號或逗號。搜尋模式當關鍵字、詳情模式當商品編號/網址，執行時自動併入上面對應欄位。從 Google Sheet / Excel 複製一整欄貼進來最快。
priceMin	integer	選填	—	只留售價 ≥ 此金額的商品（NT$，僅 search 模式）。留空表示不限。
priceMax	integer	選填	—	只留售價 ≤ 此金額的商品（NT$，僅 search 模式）。留空表示不限。
maxItems	integer	選填	50	每個關鍵字最多抓幾筆（search 模式，1-500）。item 模式不受此限，依編號/網址數量而定。
sort	enum	選填	relevance	搜尋結果排序，目前只驗證過 relevance（相關度），其他排序值尚未支援。
proxyConfiguration	object	選填	關閉	進階選項。露天對一般請求友善，預設不用 proxy 即可運作，遇到大量抓取被擋（429）才建議開啟。

---

範例

🔎 基本關鍵字搜尋

{
    "mode": "search",
    "keywords": ["羅技滑鼠"],
    "maxItems": 15
}

📦 依商品編號抓詳情

{
    "mode": "item",
    "itemIds": ["21311212469710", "22452509453494", "22319680297043"]
}

💰 價格區間搜尋（篩選二手行情帶）

{
    "mode": "search",
    "keywords": ["PlayStation 5"],
    "priceMin": 8000,
    "priceMax": 12000,
    "maxItems": 50
}

---

幾個要注意的地方

• 只抓公開資料。不需要登入、不需要露天帳號，也不會存取任何需要驗證才看得到的內容。
• 不用登入 / 不用 API token。填好 input 就能跑，沒有任何金鑰要設定。
• 走露天 rtapi 半公開 JSON 端點（search/v3、prod/v2），不是官方公開文件化的 API，但穩定可用，不開瀏覽器，成本低。
• 對露天伺服器友善。每個 domain 併發數 ≤5，遇到失敗會用指數退避重試最多 3 次。
• 跨頁 / 跨批自動去重，不會重複計費。同一商品若因搜尋分頁重疊而出現在兩批裡，只會被 push 與收費一次。
• 連續 5 頁搜尋拿不到新資料，該關鍵字會自動停止並在 log 寫下原因，不會空轉燒錢。
• 差異化玩法：二手行情追蹤。sold_count（銷售數）、price_range（價格範圍）、stock（庫存）都是抓取當下的即時值，用排程（Apify 的 Schedule）定期對同一組關鍵字跑 search 模式，把每次結果疊起來，就能畫出價格走勢、銷量曲線，觀察某類二手商品的行情變化。
• 賣場模式（依賣家帳號抓整間賣場）規劃於 v1.1，目前版本不支援。

---

常見問題

Q: 商品編號去哪找？ 打開任一露天商品頁，網址 /item/show? 後面那一串數字就是（例如 https://www.ruten.com.tw/item/show?21311212469710 的編號是 21311212469710）。也可以直接把整串商品網址貼進 itemUrls，爬蟲會自動抽出編號。

Q: 費用怎麼算？ 每次 Run 啟動收一次 actor-start（$0.005）；search 模式每筆商品列表收 search-listing（$0.002）；item 模式每筆商品詳情收 product-detail（$0.008）。都是資料成功寫入 dataset 後才收費，Run log 會印出實際收費筆數。

Q: sold_count、stock 準嗎？ 兩者都直接來自露天 rtapi 商品端點的即時值，跟商品頁當下顯示的數字一致，但露天後台可能有些微延遲同步，仍以商品頁當下顯示為準。

Q: 為什麼沒有賣家評價 / 商品新舊（condition）？ 露天目前使用的 rtapi 商品批次端點（prod/v2）本身不回這些欄位，只有 item_id、title、price 相關的基本資料與少量賣家 ID。賣家評價、評等、商品新舊狀況等欄位規劃在 v1.1 的「賣場模式」中另外串接。

Q: 二手行情怎麼用？ 用 Apify 的 Schedule 功能，設定固定間隔（例如每天一次）對同一組關鍵字跑 search 模式，把每次的 dataset 疊起來看 price、price_range、sold_count 隨時間的變化，就能大致抓出某類二手商品的價格走勢與熱銷程度。

---

部署

apify login              # 首次:貼上 Apify token(不會寫進 repo)
apify push               # 建置並上傳到 Apify Store

上架後在 Apify Console 的 Monetization 設定 PPE 事件單價: actor-start $0.005、search-listing $0.002、product-detail $0.008。

---

免責聲明

本爬蟲只收集露天拍賣公開可見的商品資料，資料僅供研究與個人用途使用，不用於任何未經授權的商業轉售。使用前請自行確認符合露天拍賣服務條款與當地法規。對於資料的正確性、即時性或完整性，本 Actor 不做任何保證，商品價格、庫存與銷售數請以露天拍賣官網當下顯示為準。

---

露天拍賣 爬蟲、露天 API、二手價格、行情追蹤、賣場監控、C2C 電商數據