Costco
Costco 商品検索 API
キーワードまたは商品番号でコストコを検索し、構造化された商品データをJSONで取得します。オンライン価格と元の価格、評価とレビュー数、会員限定と在庫のフラグ、プロモーション、ファセットを返します。warehouse_id を指定すると、その倉庫店の店頭価格、在庫状況、価格コードが各結果に追加されます。costco.com では1リクエスト2クレジット、costco.ca と海外サイトでは1クレジットです。
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/jsonquerystringrequiredキーワードまたはコストコの商品番号（1〜200文字）。
Example: olive oil
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— 台湾。
warehouse_idstringWarehousesエンドポイントで取得したコストコの倉庫店番号。その倉庫店の店頭価格、在庫状況、価格コードを各結果に追加します。オンライン価格だけでよい場合は省略します。us と ca のみ。
Example: 1062
sort_byenum<string>default:best_match結果の並び順。best_match 以外の並べ替えでは、コストコはマッチングの範囲を広げます。newest は uk、au、mx、jp、kr、tw では使えません。
Example: price_low
best_match— コストコの関連度順。price_low— 価格の安い順。price_high— 価格の高い順。top_rated— 平均評価の高い順。newest— 新着順（us と ca）。
brandsarray<string>指定したブランドのみ。最大20件（例：["Kirkland Signature"]）。us と ca のみ。
Example: ["Kirkland Signature"]
min_pricenumberオンライン価格の下限（この値を含む、0以上）。us と ca のみ。
Example: 10
max_pricenumberオンライン価格の上限（この値を含む、0以上）。us と ca のみ。
Example: 50
min_ratingnumber平均評価（星）の下限、1〜5。us と ca のみ。
Example: 4
on_saleboolean割引が適用中の商品のみ。us と ca のみ。
Example: true
in_stockboolean在庫切れの商品を除外します。us と ca のみ。
Example: true
in_warehousebooleanwarehouse_id の倉庫店で販売され、在庫がある商品のみ。warehouse_id が必要です。
Example: true
pageintegerdefault:1結果のページ番号（1から開始、1〜500）。
Example: 2
page_sizeintegerdefault:241ページあたりの件数、1〜120（uk、au、mx、jp、kr、tw では最大100）。
Example: 48
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# warehouse_id を指定すると、各行に店頭価格と価格コードが追加されます
results = client.costco.search("olive oil", warehouse_id="1062", page_size=5)
for item in results["data"]["results"]:
store = item.get("warehouse") or {}
print(item["item_number"], item["title"], item["price"], store.get("price"))Response