Catalog Items v2020-12-01 searchCatalogItems

■ Path

GET /catalog/2020-12-01/items

Operation: searchCatalogItems

■ 概要

Amazonのカタログ内の商品の詳細を取得するためのAPIです。
このAPIは、商品情報を取得するための主なツールで、
特定の商品の詳細情報を取得するために使用されます。

このAPIは、バージョンv0と2020-12-01の2つのバージョンが存在します。
それぞれで取得できる情報や呼び出し制限が異なります。

バージョンv0では、商品のタイトル、画像、ランキング、カテゴリ、重量などの商品情報を取得することができます。
しかしこのバージョンは廃止予定で、新しいバージョン2020-12-01への移行が推奨されています。

バージョン2020-12-01では、商品のタイトル、画像、メーカー、ランキングなどは引き続き取得できますが、ブランド所有者以外は重量、サイズを含む商品の属性情報が取得できません。
ただし、2022年3月現在、ブランド所有者でなくても重量、サイズなどの情報が取得できることが確認されています。

これらの情報は商品の詳細を理解したり、商品の比較を行ったりするために重要です。
またこれらの情報は、商品のリスト作成、在庫管理、価格設定などの業務にも使用されます。

■ Usage Plan

Rate  2
Burst 2

■ パラメータ

・keywords
[必須]
Amazonカタログを検索するための単語または商品識別子のカンマ区切りのリスト。
・marketplaceIds
[必須]
リクエストのAmazonマーケットプレイス識別子のカンマ区切りのリスト。
・includedData
[任意]
応答に含めるデータセットのカンマ区切りのリスト。
Default: summaries.
・brandNames
[任意]
検索を制限するブランド名のカンマ区切りのリスト。
・classificationIds
[任意]
検索を制限する分類識別子のカンマ区切りのリスト。
・pageSize
[任意]
ページごとに返される結果の数。
Maximum : 20
・pageToken
[任意]
複数ページ分の結果がある場合に、特定のページを取得するためのトークン。
・keywordsLocale
[任意]
キーワードが提供される言語。
デフォルトはマーケットプレイスのプライマリロケールです。
・locale
[任意]
ローカライズされた概要を取得するためのロケール。
デフォルトはマーケットプレイスのプライマリロケールです。

■ レスポンス

ItemSearchResults : Amazon カタログ内のアイテムと、関連するメタデータを検索します。


公式ドキュメント

https://developer-docs.amazon.com/sp-api/docs/catalog-items-api-v2020-12-01-reference#searchcatalogitems

SP-API概要メモへ戻る