PChome 24h 商品爬蟲｜搜尋、價格、庫存一鍵下載（免 API、免登入）

一個 Actor 搞定 PChome 24h 商城兩種你會用到的抓取模式：關鍵字搜尋（拿商品列表、品牌、評分）與商品詳情（依 ID/網址拿即時價格、庫存）。不需要登入、不需要 API token、批量貼上上百個關鍵字或商品 ID 都吃得下。全程走 PChome 官方 JSON 端點，不開瀏覽器，速度快、成本低。

給誰用的：做比價網站的、追蹤特定商品價格波動的、寫市場調查報告的、跑電商數據分析的、論文需要資料集的、自己寫 side project 的工程師。

---

能抓到什麼

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

欄位	說明	範例	可用模式
product_id	PChome 商品 ID	DCANNU-A900ARQAX	兩者
title	商品名稱	Logitech 羅技 M331 靜音無線滑鼠	兩者
brand	品牌	Logitech	search 只
price	目前售價（NT$）	590	兩者
original_price	原價（NT$）	790	兩者
discount_pct	折扣百分比	25	兩者
category	分類名稱（v1.0 一律 null）	—	—
category_path	分類代碼路徑	DCAA	search 只
rating	評分（0-5）	4.5	search 只
review_count	評論數	312	search 只
stock_status	庫存狀態	in_stock、out_of_stock	detail 只
is_24h_delivery	是否 24h 到貨	true	search 只
promo	促銷文案（v1.0 一律 null）	—	—
image_urls	商品圖網址陣列	["https://.../pic.jpg"]	兩者
product_url	商品網址	https://24h.pchome.com.tw/prod/DCANNU-A900ARQAX	兩者
source_mode	這筆從哪個模式來的	search、detail	兩者
source_query	抓取時用的查詢條件（關鍵字或商品 ID）	羅技滑鼠	兩者
scraped_at	抓取當下時間（ISO 8601）	2026-07-03T05:23:28.617Z	兩者

重要：brand、rating、review_count、category_path、is_24h_delivery 只有搜尋模式會有值，詳情模式一律 null（PChome 商品頁 API 本身不回這些欄位）。category 與 promo 在 v1.0 一律 null（分類名稱查表為 v1.1 功能）。反過來，stock_status 只有詳情模式才會有值，搜尋模式一律 null（搜尋列表 API 不含即時庫存）。

---

兩種模式一個爬蟲

模式	幹嘛用的	計費事件	單價
🔎 search	關鍵字搜尋，拿商品列表（含品牌、評分、分類）	search-listing（每筆）	$0.002
📦 detail	依商品 ID/網址抓單一商品的即時價格、庫存	product-detail（每筆）	$0.008

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

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

---

輸入欄位

欄位	型別	必填	預設	說明
mode	enum	建議填	search	search（關鍵字搜尋）/ detail（商品詳情）擇一。
keywords	string[]	search 模式必填	—	搜尋關鍵字，一個概念一個關鍵字最準。單次最多 50 個。
sort	enum	選填	relevance	relevance（相關度）/ sales（熱銷）/ price_asc（價格低→高）/ price_desc（價格高→低），只對 search 模式有效。
priceMin	integer	選填	—	只留售價 ≥ 此金額的商品（NT$，僅 search 模式）。留空表示不限。
priceMax	integer	選填	—	只留售價 ≤ 此金額的商品（NT$，僅 search 模式）。留空表示不限。
productIds	string[]	detail 模式必填其一	—	PChome 商品 ID，例如 DCANNU-A900ARQAX（商品網址 /prod/ 後面那段）。單次最多 100 個。
productUrls	string[]	detail 模式必填其一	—	PChome 24h 商品完整網址，例如 https://24h.pchome.com.tw/prod/DCANNU-A900ARQAX，會自動抽出 ID。單次最多 100 個。
bulkInput	string	選填	—	一行一個，按 Enter 換行，不要加引號或逗號。搜尋模式當關鍵字、詳情模式當商品 ID/網址，執行時自動併入上面對應欄位。從 Google Sheet / Excel 複製一整欄貼進來最快。
maxItems	integer	選填	50	每個關鍵字最多抓幾筆（search 模式，1-500）。detail 模式不受此限，依 ID/網址數量而定。

---

範例

🔎 基本關鍵字搜尋

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

💰 價格區間 + 依熱銷排序

{
    "mode": "search",
    "keywords": ["機械鍵盤"],
    "sort": "sales",
    "priceMin": 1000,
    "priceMax": 3000,
    "maxItems": 30
}

📦 依商品 ID 抓詳情（含庫存）

{
    "mode": "detail",
    "productIds": ["DCANNU-A900ARQAX", "DSAR07-A900G00I7"]
}

---

幾個要注意的地方

• 只抓公開資料。不需要登入、不需要 PChome 帳號，也不會存取任何需要驗證才看得到的內容。
• 不用登入 / 不用 API token。填好 input 就能跑，沒有任何金鑰要設定。
• detail 模式不含品牌 / 評分。PChome 商品詳情 API 本身沒有這些欄位，要拿品牌、評分、評論數請改用 search 模式（見上方欄位表格）。
• 對電商站友善。每個 domain 併發數 ≤5，遇到失敗會用指數退避重試最多 3 次，不會對 PChome 伺服器狂發請求。
• 同一商品若命中多個關鍵字，會以不同 source_query 各出一列（依查詢計費）。例如「羅技滑鼠」跟「無線滑鼠」兩個關鍵字都搜到同一顆滑鼠，資料會出現兩筆，source_query 分別是這兩個關鍵字，各自計費一次 search-listing。
• 評論功能（reviews）規劃於後續版本，目前版本不抓逐則評論內容，只有 search 模式的彙總 rating / review_count。

---

常見問題

Q: 商品 ID 去哪找？ 打開任一 PChome 商品頁，網址 /prod/ 後面那一段就是（例如 https://24h.pchome.com.tw/prod/DCANNU-A900ARQAX 的 ID 是 DCANNU-A900ARQAX）。也可以直接把整串商品網址貼進 productUrls，爬蟲會自動抽出 ID。

Q: 為什麼詳情模式沒有評分？ PChome 的商品詳情 API 本身就不回品牌、評分、評論數這幾個欄位，只有搜尋列表 API 才有。想拿這些資訊請用 search 模式搜同一個商品名稱或關鍵字。

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

Q: 抓不到資料怎麼辦？ 先確認關鍵字有沒有打錯字、換個更常見的關鍵字試試；detail 模式則確認商品 ID 或網址是否正確、商品是否已下架。爬蟲連續 5 次拿不到新資料就會自己停並在 log 寫原因，不會空轉燒錢。

Q: category_path 是什麼？ 這是 PChome 內部的分類代碼（例如 DCAA），不是分類名稱。代碼對照分類名稱的功能規劃在 v1.1 版本加入。

Q: is_24h_delivery 準嗎？ 這個欄位反映的是「是否為 PChome 自營商品」，PChome 自營商品通常就是 24h 到貨，準確度跟 PChome 官網顯示的一致，但仍以下單當下頁面標示為準。

---

部署

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。

---

免責聲明

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

---

PChome 爬蟲、PChome API、比價、價格追蹤、電商數據、市場調查、PChome 24h 商品資料