Costco
Costco 商品 API
一次呼叫取得最多 20 項好市多商品的完整資料:說明、特色、規格、款式變化、是否限會員與購買限制、運費,以及附開始與結束日期的促銷。每次請求 1 點。
POST/api/v1/costco/product
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonitem_idstring一個好市多商品編號或 product id,或一個 costco.com 商品 URL。請傳入 item_id 或 item_ids。
Example: 1492456
item_idsarray<string>一次呼叫最多 20 個商品編號、product id 或 URL,同樣只要 1 點。僅限 us 與 ca;其他國家每次呼叫只接受一個 item_id。
Example: ["100334960", "1492456"]
countryenum<string>default:us好市多網站。us 與 ca 支援所有參數;uk、au、mx、jp、kr 與 tw 僅支援關鍵字、排序與分頁。
Example: uk
us— costco.com,美國。ca— costco.ca,加拿大。uk— 英國。au— 澳洲。mx— 墨西哥。jp— 日本。kr— 韓國。tw— 台灣。
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
products = client.costco.product(item_ids=["100334960", "1492456"])
for p in products["data"]["products"]:
print(p["item_number"], p["title"], p["price"], p["delivery_fee"])
for promo in p["promotions"]:
print(" ", promo["amount_off"], "off until", promo["end_date"])Response
"country": "us",
"count": 2,
"not_found": [],
},
"response_time": 4207
}