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

一個 Actor 搞定 PChome 24h 商城的關鍵字搜尋（拿商品列表、價格、品牌、評分）。不需要登入、不需要 API token、批量貼上上百個關鍵字都吃得下。全程走 PChome 搜尋 JSON 端點，不開瀏覽器，速度快、成本低。

更新通知（2026-10）：商品詳情模式（detail）已停止提供。 本 Actor 現僅提供關鍵字搜尋（search 模式），搜尋結果已含價格、原價、品牌、評分與圖片。仍送出 "mode": "detail"（或只送商品 ID／網址）的 run 會立即失敗並顯示說明訊息，請改用 search 模式。

給誰用的：做比價網站的、追蹤特定商品價格波動的、寫市場調查報告的、跑電商數據分析的、論文需要資料集的、自己寫 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	庫存狀態（2026-10 起一律 null）	—	—
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	兩者
source_query	抓取時用的查詢條件（關鍵字或商品 ID）	羅技滑鼠	兩者
scraped_at	抓取當下時間（ISO 8601）	2026-07-03T05:23:28.617Z	兩者

注意：stock_status 一律為 null（搜尋列表 API 不含即時庫存；原本提供庫存的詳情模式已於 2026-10 停止提供，欄位保留以維持輸出結構不變）。category 與 promo 在 v1.0 一律 null（分類名稱查表為 v1.1 功能）。

---

模式

模式	幹嘛用的	計費事件	單價
🔎 search	關鍵字搜尋，拿商品列表（含品牌、評分、分類）	search-listing（每筆）	$0.002

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

---

輸入欄位

欄位	型別	必填	預設	說明
mode	enum	選填	search	目前僅 search（關鍵字搜尋）；detail 已於 2026-10 停止提供。
keywords	string[]	search 模式必填	—	搜尋關鍵字，一個概念一個關鍵字最準。單次最多 50 個。
sort	enum	選填	relevance	relevance（相關度）/ sales（熱銷）/ price_asc（價格低→高）/ price_desc（價格高→低）。
priceMin	integer	選填	—	只留售價 ≥ 此金額的商品（NT$)。留空表示不限。
priceMax	integer	選填	—	只留售價 ≤ 此金額的商品（NT$)。留空表示不限。
bulkInput	string	選填	—	一行一個，按 Enter 換行，不要加引號或逗號。執行時自動併入關鍵字欄位。從 Google Sheet / Excel 複製一整欄貼進來最快。
maxItems	integer	選填	50	每個關鍵字最多抓幾筆（1-500）。

---

範例

🔎 基本關鍵字搜尋

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

💰 價格區間 + 依熱銷排序

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

---

幾個要注意的地方

• 只抓公開資料。不需要登入、不需要 PChome 帳號，也不會存取任何需要驗證才看得到的內容。
• 不用登入 / 不用 API token。填好 input 就能跑，沒有任何金鑰要設定。
• 商品詳情模式已停止提供（2026-10）：原本的詳情端點所在主機在 robots.txt 中禁止爬蟲，因此移除。價格、原價、品牌、評分請直接用 search 模式取得。
• 對電商站友善。每個 domain 併發數 ≤5，遇到失敗會用指數退避重試最多 3 次，不會對 PChome 伺服器狂發請求。
• 同一商品若命中多個關鍵字，會以不同 source_query 各出一列（依查詢計費）。例如「羅技滑鼠」跟「無線滑鼠」兩個關鍵字都搜到同一顆滑鼠，資料會出現兩筆，source_query 分別是這兩個關鍵字，各自計費一次 search-listing。
• 評論功能（reviews）規劃於後續版本，目前版本不抓逐則評論內容，只有 search 模式的彙總 rating / review_count。

---

常見問題

Q: 詳情模式（detail）去哪了？ 2026-10 起停止提供。送出 "mode": "detail" 會立即失敗並顯示說明；請改用 search 模式，搜尋結果已含價格、原價、品牌、評分與圖片。

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

Q: 抓不到資料怎麼辦？ 先確認關鍵字有沒有打錯字、換個更常見的關鍵字試試。爬蟲連續 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 事件單價: apify-actor-start $0.005、search-listing $0.002。

---

📚 延伸教學與工具

這隻 actor 背後的實戰教學與免費工具，都在 AI Social API：

• 📖 教學：用 Apify + n8n 做 PChome 降價通知，連露天商品也能自動追蹤
• 📊 原創資料：站台涵蓋表：模式、欄位與定價 — 每個上架站台有哪些模式、實際回傳哪些欄位、每筆多少錢，全部從 actor 自己的 schema 生成
• 🛠 免費工具：Apify 成本試算 · 論壇輿情快查
• 🤝 不想自己跑？我幫你每天跑——排程好每天送進你的 Google Sheet 或 Slack，每月 US$299 起。

由實際經營 30 多隻上架 actor 的人維護。

---

免責聲明

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

---

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