Costco API 日本
costco.co.jp のデータを構造化JSONで取得できます。商品を検索して円建て価格、評価、レビュー数、在庫状況を受け取り、説明・画像・仕様を含む商品詳細を開き、最寄りの倉庫店を探せます。どのリクエストも "country": "jp" を付けた1回のPOSTです。
登録時に50クレジット無料。コストコ日本の検索50回分です。カード登録は不要です。
Read in EnglishLeer en españolLire en français한국어로 읽기以繁體中文閱讀
{ "data": { "country": "jp", "query": "牛乳", "corrected_query": null, "total_results": 28, "page": 1, "page_size": 24, "total_pages": 2, "count": 24, "results": [ { "position": 1, "product_id": "15750", "title": "よつ葉北海道特選牛乳ロングライフ1000ml x 12本", "english_title": "Yotsuba Hokkaido Longlife Milk 1000ml x 12 pack", "url": "https://www.costco.co.jp/Subscription/Yotsuba-Hokkaido-Longlife-Milk-1000ml-x-12-pack/p/15750", "image": "https://www.costco.co.jp/medias/sys_master/images/hfb/had/174937431605278.jpg", "price": 4498, "price_hidden": false, "price_formatted": "¥4,498", "currency": "JPY", "rating": 4.7, "reviews_count": 156, "availability": "in_stock", "member_only": false, "max_order_quantity": 500 }, { "position": 2, "product_id": "37686", "title": "キッコーマン無調整豆乳1L x 6", "english_title": "KIKKOMAN UNSWEETENED SOYMILK 1L X 6", "url": "https://www.costco.co.jp/c/KIKKOMAN-UNSWEETENED-SOYMILK-1L-X-6/p/37686", "image": "https://www.costco.co.jp/medias/sys_master/images/hd2/hd6/521758445076510.jpg", "price": 1798, "price_hidden": false, "price_formatted": "¥1,798", "currency": "JPY", "rating": 4.7, "reviews_count": 216, "availability": "in_stock", "member_only": false, "max_order_quantity": 500 } ] }, "response_time": 2331}コストコ日本に対して実際のエンドポイントをライブで呼び出します。無料で2回実行でき、その後はご自身のキーで実行できます。
ScavioのCostco API（日本）とは？
ScavioのCostco API（日本）は、costco.co.jp のデータを構造化JSONで返すREST APIです。コストコには公開APIがありませんが、Scavioの日本向け3つのPOSTエンドポイントで、円建て価格つきの商品検索、商品詳細、倉庫店検索ができます。料金は1呼び出し1クレジットで、APIキーは1つだけです。
- 3
- コストコ日本向けの稼働中エンドポイント
- 1
- 1呼び出しあたりのクレジット
- 24
- デフォルトの1ページあたり商品数
コストコ日本から取得できるデータ
商品ごとの価格、評価、在庫状況、商品詳細、近くの倉庫店。
円建て価格つきの商品検索
POST /api/v1/costco/searchcostco.co.jp を検索し、1ページ24件の結果を円建て価格、評価、レビュー数、在庫状況とともに受け取れます。レスポンスには実際の総件数も含まれ、2026年11月2日の「牛乳」の検索では28件・2ページでした。
商品詳細
POST /api/v1/costco/product検索結果の product_id で商品を開き、価格、説明、すべての画像、ブランドや内容量などの仕様、掲載カテゴリを取得します。
倉庫店検索
POST /api/v1/costco/warehouses指定した座標に近いコストコ日本の倉庫店を、warehouse_id、住所、営業時間とともに検索します。
Costco API（日本）の3つのエンドポイント
すべてのルートはPOSTで、JSONを返し、同じAPIキーで使えます。ボディに "country": "jp" を追加してください。成功した呼び出し1回につき1クレジットです。
| エンドポイント | 返すデータ | クレジット |
|---|---|---|
商品検索/api/v1/costco/search | costco.co.jp のキーワード検索結果：product_id、タイトル、英語タイトル、円建て価格と表示用価格、評価、レビュー数、在庫状況、会員限定かどうか。並べ替えとページ送りに対応 | 1 |
商品詳細/api/v1/costco/product | 日本の検索結果の product_id を指定した1商品：価格、説明、すべての画像、仕様、カテゴリ | 1 |
倉庫店検索/api/v1/costco/warehouses | 指定した緯度・経度に近いコストコ倉庫店 | 1 |
登録時の無料50クレジットで50回呼び出せます。倉庫店ごとの価格と在庫、ガソリン、クーポンブック、セール情報、クリアランス、レビュー、カテゴリ、オートコンプリートは、アメリカとカナダのコストコ専用です。 プランを見る
コードからコストコ日本を検索する
「牛乳」を検索すると、商品ごとに円建て価格、評価、レビュー数、在庫状況が返ります。右側のレスポンスは実際に取得したもので、フィールド名もそのままです。
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# コストコ日本の商品検索 - 1クレジット、1ページ24件
res = client.costco.search("牛乳", country="jp")
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="15750", country="jp"){
"data": {
"country": "jp",
"query": "牛乳",
"corrected_query": null,
"total_results": 28,
"page": 1,
"page_size": 24,
"total_pages": 2,
"count": 24,
"results": [
{
"position": 1,
"product_id": "15750",
"title": "よつ葉北海道特選牛乳ロングライフ1000ml x 12本",
"english_title": "Yotsuba Hokkaido Longlife Milk 1000ml x 12 pack",
"url": "https://www.costco.co.jp/Subscription/Yotsuba-Hokkaido-Longlife-Milk-1000ml-x-12-pack/p/15750",
"image": "https://www.costco.co.jp/medias/sys_master/images/hfb/had/174937431605278.jpg",
"price": 4498,
"price_hidden": false,
"price_formatted": "¥4,498",
"currency": "JPY",
"rating": 4.7,
"reviews_count": 156,
"availability": "in_stock",
"member_only": false,
"max_order_quantity": 500
},
{
"position": 2,
"product_id": "37686",
"title": "キッコーマン無調整豆乳1L x 6",
"english_title": "KIKKOMAN UNSWEETENED SOYMILK 1L X 6",
"url": "https://www.costco.co.jp/c/KIKKOMAN-UNSWEETENED-SOYMILK-1L-X-6/p/37686",
"image": "https://www.costco.co.jp/medias/sys_master/images/hd2/hd6/521758445076510.jpg",
"price": 1798,
"price_hidden": false,
"price_formatted": "¥1,798",
"currency": "JPY",
"rating": 4.7,
"reviews_count": 216,
"availability": "in_stock",
"member_only": false,
"max_order_quantity": 500
}
]
},
"response_time": 2331
}ほかのコストコデータAPIではだめなのか？
コストコには公開APIがなく、他社のAPIの多くはウェブサイトのカタログまでしかカバーしていません。
コストコ本体と、カタログのみのCostco API
- コストコは商品、価格、在庫のデータを提供する公開APIを用意していない
- 他社のCostco API（OpenWebNinja、Unwrangle、Piloterr、Bright Data、Oxylabs）がカバーするのは検索、商品ページ、レビュー
- 複数の倉庫店にまたがる店頭価格、ガソリン価格、クーポンブック、クリアランスコードを文書化しているものはない
ScavioのCostco API
- costco.co.jp の商品検索、商品詳細、倉庫店検索を円建て価格で
- costco.com と costco.ca は同じキーですべて利用可能：店頭価格、在庫、ガソリン、クーポンブック、クリアランス
- 日本を含むコストコのほか6か国でも商品検索と商品詳細
- キーは1つ、登録時に50クレジット無料、Scavioの全プラットフォームと同じJSON形式
他社のカバー範囲は、2026年10月時点の各社の公開ドキュメントに基づきます。Scavioは公開データのみを返します。
開発者が構築しているもの
コストコ日本の価格モニタリング
costco.co.jp で気になる商品を定期的に取得し、円建て価格を保存して変動を検知します。2026年11月2日、よつ葉北海道特選牛乳ロングライフ1000ml x 12本は4,498円でした。
search商品カタログと商品詳細
商品ごとの説明、すべての画像、仕様、カテゴリを、コストコ日本が掲載しているとおりに取得し、自社のカタログ作成や情報の拡充に使えます。
search + product検索結果でのブランドの見え方
各検索結果には掲載位置、評価、レビュー数が含まれます。キーワードごとに自社商品が何位に表示されるか、価格順や評価順に並べ替えたときにどう変わるかを測定できます。
search英語表記つきの商品データ
日本の検索結果には english_title が含まれることがあり、日本語のタイトルと英語の表記を並べて扱えます。例：「よつ葉北海道特選牛乳ロングライフ1000ml x 12本」と "Yotsuba Hokkaido Longlife Milk 1000ml x 12 pack"。
search倉庫店マップ
ユーザーの座標から最寄りのコストコ倉庫店を、住所と営業時間とともに表示します。
warehouses買い物エージェント
AIエージェントにコストコ日本をツールとして渡せます。商品の価格、ブランドの品ぞろえ、最寄りの倉庫店などに答えられるようになります。Amazon 日本と同じキーで比較することもできます。
MCP + RESTコストコ日本のデータをJSONで取得する方法
- 1
APIキーを取得する
Scavioのアカウントを作成し、ダッシュボードからキーをコピーします。登録時に50クレジットが無料で付与されます。カード登録もコストコの会員資格も不要です。
- 2
コストコ日本を検索する
{"query": "牛乳", "country": "jp"} を Authorization: Bearer ヘッダー付きで https://api.scavio.dev/api/v1/costco/search に送信します。並べ替えには sort_by、ページ送りには page を使います。
- 3
商品詳細を開く
検索結果の product_id を item_id として、"country": "jp" とともに /api/v1/costco/product に渡します。どのレスポンスも data の下に内容を格納し、credits_used と credits_remaining を併せて返します。
Costco API（日本）のよくある質問
コストコ日本に公開APIはありますか？
+
ありません。コストコは商品、価格、在庫のデータを提供する公開APIを用意していません。ScavioのCostco APIは、コストコのデータを構造化JSONで返すPOSTエンドポイントでこの空白を埋めます。costco.co.jp では商品検索、商品詳細、倉庫店検索が利用できます。
コストコ日本で使えるエンドポイントはどれですか？
+
"country": "jp" を指定した商品検索（/api/v1/costco/search）、商品詳細（/api/v1/costco/product）、倉庫店検索（/api/v1/costco/warehouses）の3つです。倉庫店ごとの価格と在庫、ガソリン価格、クーポンブック、セール情報、クリアランス検索、レビュー、カテゴリ、オートコンプリートは日本では利用できず、アメリカとカナダのコストコ専用です（クーポンブックはアメリカのみ）。
日本の検索ではどのような条件を指定できますか？
+
キーワード、並べ替え、ページ送りです。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": "jp" と一緒に送るとエラー400になります。
価格の通貨は何ですか？
+
日本円です。各結果には数値の price、コストコの表示どおりの price_formatted、currency "JPY" が含まれます。たとえば2026年11月2日のキッコーマン無調整豆乳1L x 6は、1798 と "¥1,798" でした。
コストコ日本の商品IDはどこで取得できますか？
+
"country": "jp" で検索した結果の product_id フィールドから取得します（例：15750）。IDは国ごとのサイトに固有なので、costco.com のIDは costco.co.jp では使えません。日本では商品詳細のエンドポイントに1回につき1つの item_id を渡します。最大20商品をまとめて渡せる item_ids はアメリカとカナダ専用です。
english_title とは何ですか？
+
コストコ日本のサイトが持つ商品の英語表記です。2026年11月2日の「牛乳」の検索では、title が「よつ葉北海道特選牛乳ロングライフ1000ml x 12本」、english_title が "Yotsuba Hokkaido Longlife Milk 1000ml x 12 pack" でした。英語表記がない場合は null になります。
日本のコストコ倉庫店を検索できますか？
+
はい。latitude と longitude を "country": "jp" とともに /api/v1/costco/warehouses に送信します。zip パラメーターはアメリカの郵便番号専用です。limit は1〜50（デフォルト10）で、1回の呼び出しは1クレジットです。
日本で倉庫店ごとの価格や在庫を取得できますか？
+
できません。倉庫店の店頭価格、倉庫店ごとの在庫、検索の warehouse_id 絞り込みは、アメリカとカナダのコストコ専用です。日本ではAPIは costco.co.jp のオンライン価格を返します。
コストコ日本のAPIの料金はいくらですか？
+
日本では商品検索、商品詳細、倉庫店検索のいずれも1呼び出し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が返すのはコストコの公開データのみで、会員アカウントや注文履歴にはアクセスしません。データの利用方法については、コストコの規約の順守を含めてお客様の責任となります。具体的な用途については、ご自身の法律顧問にご確認ください。