要用 API 查詢好市多台灣的商品價格，把 {"query": "衛生紙", "country": "tw"} 用 POST 送到 https://api.scavio.dev/api/v1/costco/search 即可。回應裡是 costco.com.tw 的商品，附新台幣價格、評分、評論數、庫存狀態與英文品名。每次 1 點，page_size 設為 100 時一次最多拿到 100 件商品。好市多沒有公開 API，這是不用自己寫爬蟲、也不用維護，就能拿到 JSON 價格資料最快的方法。
本文的回應全部是 2026 年 11 月 2 日實際取得的資料。
準備事項
- 一把 Scavio API 金鑰。註冊即送 50 點，不需要信用卡，也不需要好市多會員卡。
- 任何能發送 HTTP 請求的語言。範例使用 cURL 與 Python。
步驟 1：搜尋 costco.com.tw
curl -X POST 'https://api.scavio.dev/api/v1/costco/search' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"query": "衛生紙", "country": "tw", "page_size": 100}'這次搜尋一次回傳了全部 37 件商品。以下是其中一筆，數值未經修改：
{
"data": {
"country": "tw",
"query": "衛生紙",
"corrected_query": null,
"total_results": 37,
"page": 1,
"page_size": 100,
"total_pages": 1,
"count": 37,
"results": [
{
"position": 27,
"product_id": "189999",
"title": "科克蘭 三層抽取衛生紙 120抽 X 72入",
"english_title": "Kirkland Signature 3-Ply Interfold Bath Tissue 120 Sheet X 72 Count",
"url": "https://www.costco.com.tw/c/Kirkland-Signature-3-Ply-Interfold-Bath-Tissue-120-Sheet-X-72-Count/p/189999",
"image": "https://www.costco.com.tw/medias/sys_master/images/hfd/he9/228120282759198.jpg",
"price": 1085,
"price_hidden": false,
"price_formatted": "$1,085",
"currency": "TWD",
"rating": 4.8,
"reviews_count": 16297,
"availability": "in_stock",
"member_only": false,
"max_order_quantity": 500
}
]
},
"credits_used": 1
}常用欄位：
| 欄位 | 內容 |
|---|---|
product_id | costco.com.tw 的商品編號，查商品詳情時使用（例：189999） |
title / english_title | 中文品名與網站上的英文品名（沒有時為 null） |
price | 新台幣售價（數字），1085 即 NT$1,085 |
price_formatted | 與網站顯示相同的價格（"$1,085"） |
price_hidden | 網站沒有顯示價格的商品為 true，此時 price 為 null |
availability | 線上庫存狀態：in_stock 或 out_of_stock |
rating / reviews_count | 平均評分與評論數 |
步驟 2：看懂沒有價格的商品
37 件商品中有 9 件 price 為 null。這一筆是同一款科克蘭衛生紙的 24 入包裝：
{
"position": 26,
"product_id": "109999",
"title": "科克蘭 三層抽取衛生紙 120張 X 24入",
"english_title": "Kirkland Signature 3-Ply Interfold Bath Tissue 120 Sheets X 24 Count",
"url": "https://www.costco.com.tw/Warehouse-Only/Household-Supplies/Toilet-Paper-Paper-Towels/Kirkland-Signature-3-Ply-Interfold-Bath-Tissue-120-Sheets-X-24-Count/p/109999",
"price": null,
"price_hidden": true,
"price_formatted": null,
"currency": null,
"rating": 4.8,
"reviews_count": 466,
"availability": "in_stock"
}網址裡有 Warehouse-Only，好市多官網的商品頁也寫著「此為賣場獨家商品，實際庫存依各賣場貨量為主，請親洽各賣場購買」，網站上本來就沒有標價。比價時請先排除 price_hidden 為 true 的商品。
步驟 3：排序與換頁
sort_by 可以用 best_match（預設）、price_low、price_high、top_rated。要注意一個陷阱：以 {"query": "衛生紙", "country": "tw", "sort_by": "price_low", "page_size": 10} 查詢時，前 9 名全是沒有價格的商品，第 10 名才是第一個有標價的蓓比適濕式衛生紙 60張 X 9入（$399）。用 price_low 找最便宜的商品時，請在自己這端濾掉 price 為 null 的列。
換頁用 page。同一個查詢在 page_size 10 時回傳 "total_pages": 4，"page": 2 就是第 11 到 20 件。台灣的 page_size 最多 100，不填時每頁 24 件。
步驟 4：換算單價
好市多的商品入數都不一樣，比價時要換算成單價。以下從步驟 1 的結果讀出品名裡的「120抽 X 72入」，算出每 100 張的價格：
import re
import requests
resp = requests.post(
"https://api.scavio.dev/api/v1/costco/search",
headers={"Authorization": "Bearer sk_live_your_key"},
json={"query": "衛生紙", "country": "tw", "page_size": 100},
timeout=120,
)
for p in resp.json()["data"]["results"]:
m = re.search(r"(\d+)\s*[抽張]\s*X\s*(\d+)\s*[入卷捲包]", p["title"])
# 沒有標價、濕式衛生紙、紙巾與面紙不列入
if not m or p["price"] is None or any(w in p["title"] for w in ("濕", "紙巾", "面紙")):
continue
sheets = int(m.group(1)) * int(m.group(2))
print(f'{p["title"]}: {p["price_formatted"]}，每 100 張 NT${p["price"] / sheets * 100:.2f}')11 月 2 日的部分結果：
| 商品 | 售價 | 每 100 張 |
|---|---|---|
| 科克蘭 捲筒衛生紙 425張 X 30捲 | $579 | NT$4.54 |
| 可麗舒 單抽式潔淨衛生紙 250抽 X 72包 | $989 | NT$5.49 |
| 五月花 妙用綿柔抽取衛生紙 輕巧包 130抽 X 108入 | $899 | NT$6.40 |
| 科克蘭 三層抽取衛生紙 120抽 X 72入 | $1,085 | NT$12.56 |
| 舒潔 三層抽取式衛生紙 120抽 X 64入 | $1,439 | NT$18.74 |
最便宜和最貴的相差 4.1 倍。品名裡的入數寫法不一定一致，例如「425張 X 30捲 X 30入」是 30 箱的整批包裝（$16,499），正式使用前請先檢查換算結果。
步驟 5：查商品詳情
需要商品說明、所有圖片與規格時，把搜尋結果的 product_id 當成 item_id 傳入。台灣一次查一件。
curl -X POST 'https://api.scavio.dev/api/v1/costco/product' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"item_id": "189999", "country": "tw"}'回應的主要部分（images 只留 23 張中的 1 張，specifications 只留 9 項中的 3 項，categories 只留 20 項中的 4 項）：
{
"data": {
"country": "tw",
"product_id": "189999",
"title": "科克蘭 三層抽取衛生紙 120抽 X 72入",
"price": 1085,
"price_hidden": false,
"price_formatted": "$1,085",
"currency": "TWD",
"rating": 4.8,
"reviews_count": 16297,
"availability": "in_stock",
"summary": "*該商品前次原價為 $1,159，更多 New Lower Price >>",
"images": [
"https://www.costco.com.tw/medias/sys_master/images/h02/h1f/228120349409310.jpg"
],
"specifications": [
{
"name": "品名",
"value": "Kirkland Signature 科克蘭 三層抽取衛生紙"
},
{
"name": "內容量/入數",
"value": "120抽 X 24小包 X 3袋"
},
{
"name": "商品尺寸",
"value": "長 64公分 X 寬 54公分 X 高 39公分"
}
],
"categories": [
"衛生紙",
"Kirkland Signature 科克蘭",
"賣場及線上同步販售",
"最新降價"
]
},
"credits_used": 1
}summary 寫出了前次原價 $1,159，現在是 $1,085，便宜了 6.4%；categories 裡也有「最新降價」與「賣場及線上同步販售」。product_id 每個國家不同，costco.com 的編號不能用在台灣，請一律從 "country": "tw" 的搜尋結果取得。
步驟 6：查附近賣場
台灣的賣場用經緯度查詢（zip 只適用美國郵遞區號）。
curl -X POST 'https://api.scavio.dev/api/v1/costco/warehouses' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"latitude": 25.0478, "longitude": 121.517, "country": "tw", "limit": 10}'以台北車站的座標查詢，依距離回傳 10 間賣場：最近的是中和店（5.6 公里），第 10 間是台中店（134.2 公里）。以下是第 3 間新莊店（省略經緯度，hours 只留 7 筆中的 2 筆）：
{
"warehouse_id": "costcoTaiwanWarehouse011",
"name": "新莊店",
"address": {
"line1": "新莊區建國一路138號 (新莊店)",
"line2": null,
"city": null,
"zip": "242",
"country": "TW",
"formatted": "242 新北市新莊區建國一路138號 (新莊店)"
},
"phone": "02-449-9909",
"distance": "8.7 公里",
"hours": [
"星期日: 上午 10:00 - 下午 9:30",
"星期一: 上午 10:00 - 下午 9:30"
],
"services": [
"TIRE_CENTER",
"GAS_STATION",
"PHARMACY",
"HEARING_AIDS",
"FOOD_COURT",
"OPTICAL"
],
"url": "https://www.costco.com.tw/store/Xinzhuang"
}distance 是「8.7 公里」這樣的字串，不是數字。10 間賣場中，services 有 GAS_STATION 的是新莊店、桃園中壢店與北台中店；加油站油價在台灣查不到。
步驟 7：定期記錄，觀察變化
每次呼叫都是讀取當下的 costco.com.tw，所以要追蹤價格走勢，就每天固定時間存下搜尋結果，和前一天比較。以 product_id 為鍵，比對 price 與 availability，就能抓到降價與缺貨。台灣的回應比較慢，這次的呼叫花了 12 到 18 秒，請把逾時設長一點，並排程在背景執行。
台灣可用的端點
| 端點 | 內容 | 點數 |
|---|---|---|
POST /api/v1/costco/search | 關鍵字搜尋，可排序、換頁，一次最多 100 件 | 1 |
POST /api/v1/costco/product | 單一商品詳情：說明、圖片、規格、分類 | 1 |
POST /api/v1/costco/warehouses | 依經緯度查附近賣場 | 1 |
各賣場價格與庫存、加油站油價、折價券手冊（優惠護照）、優惠資訊、出清、評論、分類與自動完成，都只支援美國與加拿大的好市多，台灣無法使用（折價券手冊僅限美國）。
使用限制
- 台灣的搜尋只能用
query、sort_by、page、page_size。依文件，送出warehouse_id、品牌、價格或評分篩選、on_sale、in_stock，或把sort_by設為 newest，都會回傳 400。 - 價格是 costco.com.tw 的線上售價，不是賣場現場價格。
- 商品詳情一次一件；一次最多查 20 件的
item_ids只適用美國與加拿大。
費用
台灣的搜尋、商品詳情與賣場查詢都是每次 1 點。以 Growth 方案年繳換算，每 1,000 點約 2 美元，一次 100 件商品的搜尋約 0.002 美元。每天搜尋 50 個關鍵字，一個月約 1,500 點，放得進每月 30 美元的 Project 方案（7,000 點）。註冊送的 50 點可以搜尋 50 次。詳情請見價格頁面。
免費試用好市多 Costco 台灣 API（50 點，免信用卡）。註冊前可以在好市多 Costco 台灣 API 頁面試跑即時示範。與其他 API 的比較請看4 款好市多台灣商品與價格資料 API 比較；美國與加拿大好市多的賣場價格與庫存，請見英文版 Costco API 頁面。
Frequently asked questions
怎麼用程式查詢好市多台灣的價格？
把關鍵字和 "country": "tw" 用 POST 送到 Scavio 的好市多 Costco 台灣 API。一次呼叫最多回傳 100 件商品，附新台幣 price、網站顯示用的 price_formatted、評分、評論數與庫存狀態，每次 1 點，註冊即送 50 點。
好市多的現場價格查得到嗎？
在台灣查不到。API 回傳的是 costco.com.tw 的線上售價與線上庫存狀態。賣場獨家商品在官網上本來就沒有標價，這時 price 為 null、price_hidden 為 true。2026 年 11 月 2 日搜尋「衛生紙」的 37 件商品中，有 9 件是這種情況。
怎麼知道好市多的商品降價了？
最直接的方法是每天記錄搜尋結果的 price，和前一天比較。商品詳情的 summary 有時也會寫出前次原價，例如科克蘭三層抽取衛生紙 120抽 X 72入的 summary 是「*該商品前次原價為 $1,159」，當天售價為 $1,085。
每天查價要花多少錢？
搜尋一個關鍵字最多回傳 100 件商品，每次 1 點。每天搜尋 50 個關鍵字，一個月約 1,500 點，以 Growth 方案年繳換算約 3 美元，也放得進每月 30 美元的 Project 方案（7,000 點）。