Amazon PA-API 使い方 完全ガイド【公式無料API活用】
Amazon Product Advertising API(PA-API 5.0)は、Amazon が公式に提供する商品データAPI です。出品者・アフィリエイターが価格・BSR・レビュー・在庫情報を プログラムから取得できる無料の公式手段です。本記事では PA-API の使い方を出品者視点で完全解説します。
PA-API とは何か
PA-API は Amazon が提供する商品データ取得APIで、現行は5.0版(2019年公開)。amazon.co.jp / amazon.com / amazon.de など各国版に対応し、商品情報・価格・BSR・カテゴリ・レビュー数・画像URLなどを XML/JSON で取得できます。
利用条件(重要)
- Amazonアソシエイト登録必須(無料・5分)
- 直近30日で3件の売上を維持(条件未達でアクセス停止)
- 初期180日間は売上3件達成までの猶予期間
つまり、自前で PA-API を使い続けるには Amazon アソシエイトとして月数千円の売上を維持する必要があります。
キー取得手順
- Amazon アソシエイトに登録
- 管理画面 → 「ツール」→「Product Advertising API」
- 「認証情報を追加」→ Access Key(公開鍵) + Secret Key(秘密鍵)を発行
- AssociateTag(リンクID、例: ut0211-22)を確認
主要エンドポイント
SearchItems(キーワード検索)
キーワードで商品を検索し、最大10件取得。BrowseNodeId 指定でカテゴリ絞り込み可能。
GetItems(ASIN 指定)
ASIN を指定して詳細データを取得。最大10件まで一括リクエスト可能。
GetBrowseNodes(カテゴリ階層)
BrowseNodeId からカテゴリ階層情報・子ノード一覧を取得。
レート制限と料金
| 項目 | 初期 | 月売上1万円 | 月売上10万円 |
|---|---|---|---|
| TPS | 1 | 1 | 1 |
| 1日リクエスト数 | 8,640 | 17,280 | 86,400 |
| 料金 | 無料 | 無料 | 無料 |
取得可能な Resources(リソース)
- ItemInfo.Title - 商品名
- ItemInfo.ByLineInfo - ブランド・メーカー
- Images.Primary.Large - メイン画像
- Offers.Listings.Price - 現在価格
- Offers.Summaries.LowestPrice - 最安値
- BrowseNodeInfo.BrowseNodes.SalesRank - BSR
- CustomerReviews.StarRating - 平均評価
- CustomerReviews.Count - レビュー数
PA-API の落とし穴
- 売上が止まるとAPIアクセスも停止:副業出品者には厳しい
- BSRランキング機能はない:ベストセラー一覧取得は不可、SearchItemsで間接的に取得
- レビュー本文は取れない:レビュー数・★評価のみ
- 在庫数は取れない:「在庫あり/なし」のフラグのみ
自前実装せずに済ませる方法
「なんぼなん?」は PA-API データを既に取得・蓄積しており、出品者は自前実装なしで同等の情報を取得できます。アソシエイト登録・売上維持・APIキー管理が不要なのが大きな利点です。
実装サンプル(PHP)
ContentHub などのSDKを使うのが最も簡単です。以下は擬似コード:
$client = new PaapiClient($accessKey, $secretKey, $partnerTag);
$result = $client->searchItems([
'Keywords' => 'ワイヤレスイヤホン',
'BrowseNodeId' => '2127209051',
'ItemCount' => 10,
'Resources' => ['ItemInfo.Title', 'Offers.Listings.Price', ...],
]);
関連ガイド
よくある質問
PA-API は無料で使えますか?
基本無料ですが、Amazon アソシエイトに登録 + 直近30日に売上発生(成約3件)が条件。条件を満たさないと利用停止になります。
PA-API のレート制限は?
TPS=1(1秒に1リクエスト)、1日のリクエスト上限は売上に応じて変動。月1万円の売上で1日約8,640回まで。
PA-API の代わりに使えるサービスは?
「なんぼなん?」のように PA-API データを既に取得・蓄積しているサービスを使えば、自前実装不要で同等の情報が取得できます。
PA-API のキー取得手順は?
①Amazon アソシエイト登録 ②管理画面で「ツール → Product Advertising API」 ③Access Key + Secret Key を発行 ④AssociateTag(リンクID) と組み合わせて使用。
PA-API のおすすめエンドポイントは?
SearchItems(キーワード検索)、GetItems(ASIN 指定で詳細取得)、GetBrowseNodes(カテゴリ階層取得)の3つが基本。GetVariations は使い所限定的。