サイトのAPI図鑑B版
掲載情報が正確でない可能性があります。
ECサイト・マーケティングAPI

Amazon PA-API(Product Advertising API)の使い方完全ガイド

Amazon Product Advertising API v5を使った商品検索・詳細情報取得・Amazonアソシエイト連携の実装方法を解説します。承認条件・レート制限・日本向け設定も紹介します。

#Amazon#アソシエイト#商品検索API#EC

Amazon PA-APIとは

Amazon Product Advertising API(PA-API)はAmazonアソシエイト向けに提供されているAPIで、Amazon.co.jpの商品情報(タイトル・価格・在庫・レビュー・画像等)をプログラムから取得できます。アフィリエイトブログ・価格比較サイト・Amazonの商品を紹介するWebサービスの構築に使われています。

利用要件

  • Amazon.co.jp アソシエイト・プログラムへの参加が必須
  • 過去180日間に3件以上の売上が必要(売上がないとアクセス停止)
  • 利用規約への遵守(商品情報のキャッシュ期間制限等)

PA-API v5のセットアップ

  1. アソシエイト管理画面でPA-APIアクセスを有効化
  2. Access KeyとSecret Keyを取得
  3. npm install paapi5-nodejs-sdk でSDKをインストール(または独自実装)

商品情報取得の実装(GetItems)

import * as ProductAdvertisingAPIv1 from 'paapi5-nodejs-sdk';

const client = new ProductAdvertisingAPIv1.DefaultApi();

const getItemRequest = new ProductAdvertisingAPIv1.GetItemsRequest();
getItemRequest.PartnerTag = 'your-associate-tag-22'; // アソシエイトID
getItemRequest.PartnerType = ProductAdvertisingAPIv1.PartnerType.ASSOCIATES;
getItemRequest.Marketplace = 'www.amazon.co.jp';
getItemRequest.ItemIds = ['B0XXXXXXXXX']; // ASIN
getItemRequest.Resources = [
  'ItemInfo.Title',
  'Offers.Listings.Price',
  'Images.Primary.Large',
  'CustomerReviews.StarRating',
  'CustomerReviews.Count'
];

const response = await client.getItems(getItemRequest);
const item = response.ItemsResult.Items[0];
console.log(item.ItemInfo.Title.DisplayValue);

商品検索(SearchItems)

const searchRequest = new ProductAdvertisingAPIv1.SearchItemsRequest();
searchRequest.PartnerTag = 'your-tag-22';
searchRequest.PartnerType = ProductAdvertisingAPIv1.PartnerType.ASSOCIATES;
searchRequest.Keywords = 'ワイヤレスイヤホン';
searchRequest.SearchIndex = 'Electronics';
searchRequest.ItemCount = 10;
searchRequest.Resources = ['ItemInfo.Title', 'Offers.Listings.Price'];
searchRequest.SortBy = 'Relevance';

商品情報の表示ルール

PA-APIで取得した商品情報の表示にはAmazonの利用規約に従ったルールがあります。

  • 価格データのキャッシュ期限(原則として24時間以内に更新)
  • Amazonのロゴ・商標の適切な使用
  • 「Amazon.co.jpで購入」リンクを明示する
  • アフィリエイトの開示(広告を含むコンテンツの明示)

まとめ

Amazon PA-APIは日本最大のECサイトの商品データを活用できる強力なAPIです。アソシエイト参加・売上実績の維持・利用規約遵守が条件ですが、収益化しながら商品情報を活用できるユニークなAPIです。初期の売上実績を積みながらAPIを活用するサイト設計が重要です。

よくある質問

Q.PA-APIを使うにはAmazonアソシエイトへの参加が必要ですか?

はい。Amazon PA-APIはAmazonアソシエイト・プログラムへの参加が必須です。PA-APIへのアクセスを維持するためには、過去180日間に3件以上の売上が必要です。実績のない状態ではAPIアクセスが無効になります。

Q.PA-APIのレート制限はどのくらいですか?

PA-APIのリクエスト制限は売上実績に連動します。初期は1秒あたり1リクエストほどです。成熟したアソシエイトアカウントでは制限が緩和されます。制限を超えると429エラーが返ります。

Q.商品の画像URLはPA-APIから取得できますか?

はい。PA-APIのGetItemsリクエストでImages.Primary.Large等のリソースを指定することで、商品画像のURLを取得できます。ただし画像の直接リンクはAmazonのサーバーに依存するため、URLが変わる可能性があります。

関連記事