好市多 Costco 台灣 API
以結構化 JSON 取得 costco.com.tw 資料：搜尋任何商品，取得新台幣價格、評分、評論數與庫存狀態；開啟附說明、圖片與規格的商品詳情；並找出最近的賣場。每次查詢只要一個帶 "country": "tw" 的 POST。
註冊即送 50 點，足夠搜尋好市多台灣 50 次。免信用卡。
{ "data": { "country": "tw", "query": "牛奶", "corrected_query": null, "total_results": 81, "page": 1, "page_size": 24, "total_pages": 4, "count": 24, "results": [ { "position": 1, "product_id": "298720", "title": "Binggrae 草莓牛奶 保久調味乳 200毫升 X 24入", "english_title": "Binggrae Strawberry Flavored Milk Drink 200 ml X 24-Pack", "url": "https://www.costco.com.tw/Food-Dining/Drinks/Beverages-Juice/Binggrae-Strawberry-Flavored-Milk-Drink-200-ml-X-24-Pack/p/298720", "image": "https://www.costco.com.tw/medias/sys_master/images/h6f/h7b/206972373663774.jpg", "price": 669, "price_hidden": false, "price_formatted": "$669", "currency": "TWD", "rating": 4.8, "reviews_count": 359, "availability": "in_stock", "member_only": false, "max_order_quantity": 500 }, { "position": 2, "product_id": "162643", "title": "桂格 高鈣高蛋白飲 核桃牛奶風味 250毫升 X 24入", "english_title": "Quaker Total Protein Drink Walnut Milk Flavor 250 ml X 24-Pack", "url": "https://www.costco.com.tw/Health-Beauty/Sports-Performance/Whey-Protein-Powder/Quaker-Total-Protein-Drink-Walnut-Milk-Flavor-250-ml-X-24-Pack/p/162643", "image": "https://www.costco.com.tw/medias/sys_master/images/h99/he5/504582158909470.jpg", "price": 865, "price_hidden": false, "price_formatted": "$865", "currency": "TWD", "rating": 0, "reviews_count": null, "availability": "in_stock", "member_only": false, "max_order_quantity": 5 } ] }, "response_time": 1289}即時呼叫好市多台灣的實際端點。可免費執行 2 次，之後請使用您自己的金鑰。
什麼是 Scavio 的好市多台灣 API？
Scavio 的好市多台灣 API 是一個 REST API，以結構化 JSON 回傳 costco.com.tw 的資料。好市多沒有公開 API；Scavio 為台灣提供的 3 個 POST 端點涵蓋附新台幣價格的商品搜尋、商品詳情與賣場查詢，每次呼叫 1 點，只需一組 API 金鑰。
- 3
- 好市多台灣可用端點，已上線
- 1
- 每次呼叫的點數
- 24
- 預設每頁商品數
您可以從好市多台灣取得的資料
每項商品的價格、評分與庫存狀態，完整的商品詳情，以及最近的賣場。
含新台幣價格的搜尋
POST /api/v1/costco/search搜尋 costco.com.tw，每頁回傳 24 筆結果，每筆都附新台幣（TWD）價格、評分、評論數與庫存狀態。回應中也包含實際的總筆數：2026 年 11 月 2 日搜尋「牛奶」共 81 筆、4 頁。
商品詳情
POST /api/v1/costco/product用搜尋取得的 product_id 開啟商品：價格、說明、所有圖片、品牌與容量等規格，以及商品所屬的分類。
賣場查詢
POST /api/v1/costco/warehouses依座標找出最近的好市多台灣賣場，附 warehouse_id、地址與營業時間。
好市多台灣 API 的 3 個端點
所有路徑都是 POST、回傳 JSON，並使用同一組 API 金鑰。請在本文加上 "country": "tw"。每次成功呼叫 1 點。
| 端點 | 回傳資料 | 點數 |
|---|---|---|
搜尋/api/v1/costco/search | 以關鍵字搜尋 costco.com.tw 商品：product_id、中文與英文品名、新台幣價格與顯示價格、評分、評論數、庫存狀態、是否限會員；支援排序與分頁 | 1 |
商品詳情/api/v1/costco/product | 以台灣搜尋結果的 product_id 查詢單一商品：價格、說明、所有圖片、規格與分類 | 1 |
賣場查詢/api/v1/costco/warehouses | 距離指定緯度與經度最近的好市多賣場 | 1 |
註冊贈送的 50 點可呼叫 50 次。各賣場價格與庫存、加油站、折價券手冊、優惠、出清、評論、分類與自動完成僅限美國與加拿大好市多。 查看方案
在您的程式中搜尋好市多台灣
搜尋「牛奶」會回傳每項商品的新台幣價格、評分、評論數與庫存狀態。右側的回應是實際擷取的結果，欄位名稱完全相同。
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# 搜尋好市多台灣 - 1 點，每頁 24 項商品
res = client.costco.search("牛奶", country="tw")
for item in res["data"]["results"]:
print(item["product_id"], item["price"], item["currency"], item["title"])
# 用台灣搜尋結果的 product_id 查詢商品詳情 - 1 點
detail = client.costco.product(item_id="298720", country="tw"){
"data": {
"country": "tw",
"query": "牛奶",
"corrected_query": null,
"total_results": 81,
"page": 1,
"page_size": 24,
"total_pages": 4,
"count": 24,
"results": [
{
"position": 1,
"product_id": "298720",
"title": "Binggrae 草莓牛奶 保久調味乳 200毫升 X 24入",
"english_title": "Binggrae Strawberry Flavored Milk Drink 200 ml X 24-Pack",
"url": "https://www.costco.com.tw/Food-Dining/Drinks/Beverages-Juice/Binggrae-Strawberry-Flavored-Milk-Drink-200-ml-X-24-Pack/p/298720",
"image": "https://www.costco.com.tw/medias/sys_master/images/h6f/h7b/206972373663774.jpg",
"price": 669,
"price_hidden": false,
"price_formatted": "$669",
"currency": "TWD",
"rating": 4.8,
"reviews_count": 359,
"availability": "in_stock",
"member_only": false,
"max_order_quantity": 500
},
{
"position": 2,
"product_id": "162643",
"title": "桂格 高鈣高蛋白飲 核桃牛奶風味 250毫升 X 24入",
"english_title": "Quaker Total Protein Drink Walnut Milk Flavor 250 ml X 24-Pack",
"url": "https://www.costco.com.tw/Health-Beauty/Sports-Performance/Whey-Protein-Powder/Quaker-Total-Protein-Drink-Walnut-Milk-Flavor-250-ml-X-24-Pack/p/162643",
"image": "https://www.costco.com.tw/medias/sys_master/images/h99/he5/504582158909470.jpg",
"price": 865,
"price_hidden": false,
"price_formatted": "$865",
"currency": "TWD",
"rating": 0,
"reviews_count": null,
"availability": "in_stock",
"member_only": false,
"max_order_quantity": 5
}
]
},
"response_time": 1289
}為什麼不用其他好市多資料 API？
好市多沒有公開 API，而第三方 API 大多只涵蓋網站上的商品目錄。
好市多，以及只涵蓋商品目錄的好市多 API
- 好市多並未提供商品、價格或庫存資料的公開 API
- 第三方好市多 API（OpenWebNinja、Unwrangle、Piloterr、Bright Data、Oxylabs）涵蓋搜尋、商品詳情與評論
- 沒有一家記載多個賣場的貨架價格、加油站油價、折價券手冊或出清代碼
Scavio 的 Costco API
- costco.com.tw 的搜尋、商品詳情與賣場查詢，附新台幣價格
- 同一組金鑰完整支援 costco.com 與 costco.ca：賣場價格、庫存、油價、折價券手冊與出清
- 另外 6 個好市多國家支援搜尋與商品詳情，包括台灣
- 一組金鑰、註冊即送 50 點，與所有 Scavio 平台相同的 JSON 格式
第三方涵蓋範圍依各供應商截至 2026 年 10 月的公開文件整理。Scavio 只回傳公開資料。
開發者用它打造的應用
好市多台灣價格監測
定期查詢 costco.com.tw 上您關注的商品並記錄新台幣價格，掌握每一次價格變動。2026 年 11 月 2 日，Binggrae 草莓牛奶 保久調味乳 200毫升 X 24入的價格是 NT$669。
search商品目錄建置
依好市多台灣刊登的內容，取得每項商品的說明、所有圖片、規格與分類，用來建立或充實您的商品目錄。搜尋結果的 english_title 也提供英文品名。
search + product搜尋排名追蹤
每筆結果都附排名、評分與評論數。追蹤您的商品在各個關鍵字下排在第幾位，以及依價格或評分排序時如何變化。
search跨通路比價
用同一組 API 金鑰查詢好市多台灣與 Google Shopping 等 Scavio 其他平台，以格式相近的 JSON 回應進行比較。
search + Google Shopping API賣場地圖
依使用者的座標顯示最近的好市多賣場，附地址與營業時間。
warehouses購物代理
把好市多台灣接上 AI 代理當作工具：商品多少錢、某個品牌有哪些選擇、最近的賣場在哪裡，代理都能直接查詢。
MCP + REST如何以 JSON 取得好市多台灣資料
- 1
取得 API 金鑰
建立 Scavio 帳號，從控制台複製您的金鑰。註冊即送 50 點，免信用卡，也不需要好市多會員卡。
- 2
搜尋好市多台灣
帶著 Authorization: Bearer 標頭，將 {"query": "牛奶", "country": "tw"} 送到 https://api.scavio.dev/api/v1/costco/search。用 sort_by 排序，用 page 換頁。
- 3
開啟商品詳情
將結果中的 product_id 作為 item_id，連同 "country": "tw" 送到 /api/v1/costco/product。每個回應的內容都放在 data 中，並附上 credits_used 與 credits_remaining。
好市多台灣 API 常見問題
好市多台灣有公開的 API 嗎？
+
沒有。好市多並未提供商品、價格或庫存資料的公開 API。Scavio 的 Costco API 以 POST 端點將好市多資料回傳為結構化 JSON，填補了這個缺口；costco.com.tw 可使用搜尋、商品詳情與賣場查詢。
好市多台灣可以使用哪些端點？
+
搜尋（/api/v1/costco/search）、商品詳情（/api/v1/costco/product）與賣場查詢（/api/v1/costco/warehouses），請求時加上 "country": "tw"。各賣場價格、各賣場庫存、加油站油價、折價券手冊、優惠、出清搜尋、評論、分類與自動完成在台灣不提供，僅適用於美國與加拿大好市多（折價券手冊僅限美國）。
台灣的搜尋支援哪些篩選條件？
+
關鍵字、排序與分頁：query、sort_by（best_match、price_low、price_high 或 top_rated；台灣不支援 newest）、page（1-500）與 page_size（最多 100）。warehouse_id、brands、價格與評分篩選、on_sale、in_stock 與 in_warehouse 僅限美國與加拿大；搭配 "country": "tw" 送出會回傳 400 錯誤。
價格是用什麼幣別？
+
新台幣。每筆結果都有數字格式的 price、好市多網站顯示文字的 price_formatted，以及 currency "TWD"：例如 2026 年 11 月 2 日，Binggrae 草莓牛奶 保久調味乳 200毫升 X 24入回傳 669 與 "$669"。
可以取得英文品名嗎？
+
可以。台灣的搜尋結果除了中文 title，還有 english_title。例如上述草莓牛奶的 english_title 是 "Binggrae Strawberry Flavored Milk Drink 200 ml X 24-Pack"。
如何取得好市多台灣的商品 id？
+
從 "country": "tw" 搜尋結果的 product_id 欄位取得，例如 298720。各國網站的 id 互不通用，所以 costco.com 的 id 無法用在 costco.com.tw。在台灣，商品詳情端點每次呼叫只接受一個 item_id；最多 20 項的 item_ids 僅限美國與加拿大。
商品詳情包含哪些資料？
+
品名、URL、主圖與所有圖片、新台幣價格與顯示價格、評分、評論數、庫存狀態、是否限會員、最大訂購數量、說明、規格與分類。
可以查詢台灣的好市多賣場嗎？
+
可以。將 latitude 與 longitude 連同 "country": "tw" 送到 /api/v1/costco/warehouses；zip 參數僅適用美國郵遞區號。limit 為 1-50（預設 10），每次呼叫 1 點。
台灣可以取得各賣場的價格或庫存嗎？
+
不行。賣場價格、各賣場庫存與搜尋的 warehouse_id 篩選僅限美國與加拿大好市多。在台灣，API 回傳的是 costco.com.tw 的線上價格。
好市多台灣 API 的費用是多少？
+
在台灣，搜尋、商品詳情與賣場查詢每次呼叫都是 1 點（costco.com 的搜尋為 2 點）。新帳號註冊即送 50 點，免信用卡；付費方案每月 30 美元起，含 7,000 點。
資料有多即時？
+
每個請求都在呼叫當下即時讀取好市多，所以價格與庫存狀態就是好市多當時顯示的內容。沒有任何資料來自夜間的副本。
可以用哪些程式語言和工具？
+
每個端點都是帶 JSON 本文的一般 HTTPS POST，任何程式語言都能使用。Scavio 也提供 Python 與 JavaScript SDK、給 AI 代理用的遠端 MCP 伺服器（mcp.scavio.dev），以及 n8n 社群節點，全部使用同一組 API 金鑰。
支援哪些國家的好市多？
+
美國（costco.com）與加拿大（costco.ca）支援所有端點，但折價券手冊僅限美國。搜尋、商品詳情與賣場查詢也支援墨西哥、英國、澳洲、日本、韓國與台灣的好市多，搜尋支援關鍵字、排序與分頁。
使用好市多台灣的資料合法嗎？
+
Scavio 只回傳好市多的公開資料，不會存取會員帳號或訂單紀錄。資料的使用方式由您負責，包括遵守好市多的使用條款。具體的使用情境請諮詢您自己的律師。