タイトル: Product Advertising API (PA-API)
SEOタイトル: Amazon PA-API 5.0 完全ガイド(認証 Sigv4/SearchItems/レート制限/SDK)
Amazonの商品APIを利用する場合、PA-API 5.0は現在の推奨導入先ではありません。既存サンプルは保持し、Creators APIへの移行と旧仕様の境界を整理します。
2026年10月確認: PA-API 5.0も移行が必要
PA-API 5.0を現在の新規導入先として勧める説明は更新が必要です。 Amazon公式はPA-API 5の廃止と後継Creators APIへの移行を案内し、旧PA-API 5への要求に403 AccessDeniedExceptionが返る例を示しています。これは署名を調整すれば利用を再開できる、という案内ではありません。
公式の廃止案内と移行ガイドを先に確認してください。Creators APIはOAuth 2.0を使い、旧PA-APIのAWS Access Key / Secret Keyはそのまま利用できません。Credential ID / Credential Secretと対象の資格情報Versionを取得し、APIの送信先・ヘッダー・項目名も変更します。秘密情報をこのページや問い合わせへ貼り付けないでください。
移行前に確認すること
- 現在の呼出先・対象国・Partner Tag・使用する操作を一覧にする。
- Creators API用の認証情報とVersionを取得し、旧AWSキーを混用しない。
- 送信先、認証ヘッダー、lowerCamelCaseの項目やResourcesの差を公式移行表で確認する。
- OAuthトークンの期限・更新、HTTPエラーとレスポンス内エラーを分けて試験する。APIの表示成功だけで移行完了としない。
| この記事の要点 |
|
PA-API とは
以下の説明・サンプルは従来のPA-API 5向けの保守資料です。商品取得の新規実装はCreators APIの公式資料を先に確認します。子ページから旧手順・レスポンス・エラー資料を選択してください。
Product Advertising API(PA-API)は、Amazon アソシエイト(アフィリエイト)が Amazon 商品情報・価格・在庫状況・カスタマーレビュー要約などをプログラムから取得するための公式 API です。アフィリエイトリンク自動生成、比較サイト構築、書籍データベースの集計などに使われます。
| 項目 | 内容 |
|---|---|
| 旧バージョン | PA-API 5.0(現在は廃止案内対象)。後継はCreators API |
| 必要なアカウント | Amazon アソシエイト(地域別) |
| 認証 | AWS Signature Version 4 (Sigv4) |
| レスポンス | JSON(POST + JSON ペイロード) |
| レート制限 | 旧PA-APIの数値を現行枠としない。対象アカウントとCreators API公式案内で確認 |
| 料金 | 旧説明から現在の料金・資格を判断せず、対象地域の公式条件を確認 |
利用条件と制約
- Amazon アソシエイトアカウントが必要(地域別、日本なら
affiliate.amazon.co.jp) - アソシエイト参加条件とAPI利用資格は分け、現行の対象地域・アカウントの案内で確認する。180日という数字だけでAPI停止原因を判断しない
- 取得データの保存・表示は現行規約の対象データ別の条件を確認する。一律の保存時間と解釈しない
- レート制限と利用資格は対象APIの公式案内を確認し、過去のPA-API数値から現在の上限を推測しない
認証情報の取得
以下は旧PA-API向けの取得手順の記録です。新しいCreators APIでは公式の登録手順に従い、Credential ID / Secret / Versionを管理します。旧Access Keyの再発行だけでは移行になりません。
- Amazon アソシエイトにログイン
- 「ツール」→「Product Advertising API」→ 「認証情報を管理する」
- Access Key ID と Secret Access Key(Sigv4 署名用)を発行
- 同ページで Partner Tag(トラッキング ID)を確認
Secret Key は表示時に必ず保管してください。後から再表示できません。
エンドポイントと地域
以下は旧PA-API 5向けの参考情報です。Creators APIの現在の仕様として流用しないでください。
| 地域 | Marketplace | Host | Region |
|---|---|---|---|
| 日本 | www.amazon.co.jp | webservices.amazon.co.jp | us-west-2 |
| 米国 | www.amazon.com | webservices.amazon.com | us-east-1 |
| 英国 | www.amazon.co.uk | webservices.amazon.co.uk | eu-west-1 |
| ドイツ | www.amazon.de | webservices.amazon.de | eu-west-1 |
主要オペレーション
以下は旧PA-API 5向けの参考情報です。Creators APIの現在の仕様として流用しないでください。
| オペレーション | 用途 |
|---|---|
SearchItems | キーワード/カテゴリ検索 |
GetItems | ASIN 指定で個別取得(最大 10 件) |
GetVariations | 色違い/サイズ違いのバリエーション取得 |
GetBrowseNodes | カテゴリ階層取得 |
Resources パラメータ
以下は旧PA-API 5向けの参考情報です。Creators APIの現在の仕様として流用しないでください。
レスポンスに含めるフィールドを Resources で明示します。指定しないとごく一部しか返らないので注意。
{
"Keywords": "ノートPC",
"SearchIndex": "Electronics",
"PartnerTag": "yourtag-22",
"PartnerType": "Associates",
"Marketplace": "www.amazon.co.jp",
"Resources": [
"ItemInfo.Title",
"ItemInfo.Features",
"Images.Primary.Large",
"Offers.Listings.Price",
"Offers.Listings.Availability.Message",
"BrowseNodeInfo.BrowseNodes"
]
}
cURL でリクエスト例
以下は廃止案内対象の旧PA-API用コードです。 固定された日時や省略署名のまま送信する完成例ではなく、現在の導入手順として実行しないでください。
Sigv4 署名生成が複雑なので、本来は SDK 利用が推奨ですが、雰囲気をつかむための例:
# 署名生成済を前提とした POST 例
curl -X POST \
-H "Host: webservices.amazon.co.jp" \
-H "Content-Type: application/json; charset=UTF-8" \
-H "X-Amz-Date: 20260610T000000Z" \
-H "X-Amz-Target: com.amazon.paapi5.v1.ProductAdvertisingAPIv1.SearchItems" \
-H "Content-Encoding: amz-1.0" \
-H "Authorization: AWS4-HMAC-SHA256 Credential=..., SignedHeaders=..., Signature=..." \
--data @body.json \
https://webservices.amazon.co.jp/paapi5/searchitems
SDK 利用(PHP)
以下の旧インストール断片とSDKコードは原資料として保持しますが、実行を勧めません。 記載のComposer名・名前空間を現行の公式配布として保証しません。現在はCreators API公式SDK案内から対象言語の配布物・依存・サンプルを確認します。旧PA-APIのパッケージ名を推測で置換しないでください。
composer require amazon-paapi5-php-sdkuse Amazon\ProductAdvertisingAPI\v1\ApiException;
use Amazon\ProductAdvertisingAPI\v1\Configuration;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\api\DefaultApi;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\SearchItemsRequest;
$config = new Configuration();
$config->setAccessKey('AKIA...');
$config->setSecretKey('xxxxxxx');
$config->setHost('webservices.amazon.co.jp');
$config->setRegion('us-west-2');
$api = new DefaultApi(new \GuzzleHttp\Client(), $config);
$req = new SearchItemsRequest();
$req->setSearchIndex('Books');
$req->setKeywords('PHP');
$req->setItemCount(5);
$req->setPartnerTag('yourtag-22');
$req->setPartnerType('Associates');
$req->setResources(['Images.Primary.Large','ItemInfo.Title','Offers.Listings.Price']);
try {
$res = $api->searchItems($req);
foreach ($res->getSearchResult()->getItems() as $item) {
echo $item->getItemInfo()->getTitle()->getDisplayValue(), "\n";
}
} catch (ApiException $e) {
echo $e->getMessage();
}
SDK 利用(Python)
以下も旧PA-API用の未実行コードです。既存環境との比較用に残しますが、Creators APIにそのまま利用できる例ではありません。
from paapi5_python_sdk.api.default_api import DefaultApi
from paapi5_python_sdk.search_items_request import SearchItemsRequest
from paapi5_python_sdk.partner_type import PartnerType
api = DefaultApi(
access_key='AKIA...', secret_key='xxxx',
host='webservices.amazon.co.jp', region='us-west-2'
)
req = SearchItemsRequest(
partner_tag='yourtag-22',
partner_type=PartnerType.ASSOCIATES,
keywords='Python',
search_index='Books',
item_count=5,
resources=['Images.Primary.Large','ItemInfo.Title','Offers.Listings.Price'],
)
res = api.search_items(req)
for it in res.search_result.items:
print(it.item_info.title.display_value)
レート制限とリトライ
下の旧コードは失敗時に結果変数が設定されない場合があり、完成した例外処理ではありません。廃止によるAccessDeniedをバックオフで繰り返さず、エラーを分類します。現行Creators APIのレート制限は公式のAPI Ratesを確認してください。
制限を超えると 429 Too Many Requests / RequestThrottled エラーが返ります。指数バックオフで再試行してください。
import time, random
for attempt in range(5):
try:
res = api.search_items(req); break
except ApiException as e:
if e.status == 429:
time.sleep((2 ** attempt) + random.random())
else:
raise
他 EC プラットフォームの API との比較
以下は従来の比較メモです。他社APIの現在の料金・認証・上限を今回再照合したものではなく、導入判断には各社の公式仕様を確認してください。Amazon PA-API 5を現在も利用できるサービスの比較対象として扱わないでください。
| API | 認証 | レート | 備考 |
|---|---|---|---|
| Amazon PA-API 5.0 | Sigv4 | 1 req/s〜 | アソシエイト連携前提 |
| 楽天市場 商品検索 API | App ID | 1 req/s 目安 | アフィリエイト ID 任意 |
| Yahoo!ショッピング API | Yahoo! Client ID | 制限あり(公開値) | 商品検索 / カテゴリ取得 |
| 楽天ブックス/Kobo | App ID | 同上 | 書籍特化 |
規約上の重要ポイント
- 取得データの保存・更新・表示条件は現行規約とデータ種別で確認する。全データ共通で24時間と断定しない
- 表示する場合は「価格は変動する可能性があります」等の文言
- API キーの他者共有禁止
- 取得した画像のサイズ改変は許可範囲内(規約参照)
- アソシエイト規約に従って Partner Tag を必ず含める
FAQ
Q: 4.0 系のサンプルコードがネット上に大量にあるが、まだ使える?
A: 使えません。旧ItemSearchを現在の導入手順として使いません。5.0も廃止案内対象なので、現在の連携はCreators APIの移行ガイドを確認してください。
Q: 「Your account is missing approved sales」エラーが返る
A: エラーコードとアカウントの現行の利用資格・通知を確認します。参加申請の条件とAPI利用資格を同一視せず、180日という数字だけで再申請が必要とは判断しません。
Q: SearchItems で「ノートPC」を検索しても 0 件
A: SearchIndex が Books 等になっていませんか。All または Electronics を指定してみてください。Marketplace が違うとレコードゼロもよくあります。