この内容は古いバージョンです。最新バージョンを表示するには、戻るボタンを押してください。
バージョン:11
ページ更新者:atom
更新日時:2026-10-14 09:04:59

タイトル: Product Advertising API (PA-API)
SEOタイトル: Amazon PA-API 5.0 完全ガイド(認証 Sigv4/SearchItems/レート制限/SDK)

Amazonの商品APIを利用する場合、PA-API 5.0は現在の推奨導入先ではありません。既存サンプルは保持し、Creators APIへの移行と旧仕様の境界を整理します。

旧ItemSearch、PA-API5、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の送信先・ヘッダー・項目名も変更します。秘密情報をこのページや問い合わせへ貼り付けないでください。

移行前に確認すること

  1. 現在の呼出先・対象国・Partner Tag・使用する操作を一覧にする。
  2. Creators API用の認証情報とVersionを取得し、旧AWSキーを混用しない。
  3. 送信先、認証ヘッダー、lowerCamelCaseの項目やResourcesの差を公式移行表で確認する。
  4. OAuthトークンの期限・更新、HTTPエラーとレスポンス内エラーを分けて試験する。APIの表示成功だけで移行完了としない。
この記事の要点
  • PA-APIはAmazonアソシエイトが商品情報を取得するために使っていた従来API。5.0も廃止案内の対象。後継Creators APIへの移行を確認
  • 以下は旧PA-APIの保守資料。現在のCreators APIでは新しい認証情報と対応するPartner Tag等を確認
  • 旧PA-API 5の認証は AWS Signature Version 4。旧エンドポイントは webservices.amazon.co.jp 等の地域別 URL
  • 主要オペレーション: SearchItems/GetItems/GetVariations/GetBrowseNodes
  • 現行の利用条件・レート・ResourcesはCreators 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の再発行だけでは移行になりません。

  1. Amazon アソシエイトにログイン
  2. 「ツール」→「Product Advertising API」→ 「認証情報を管理する」
  3. Access Key ID と Secret Access Key(Sigv4 署名用)を発行
  4. 同ページで Partner Tag(トラッキング ID)を確認

Secret Key は表示時に必ず保管してください。後から再表示できません。

エンドポイントと地域

以下は旧PA-API 5向けの参考情報です。Creators APIの現在の仕様として流用しないでください。

地域MarketplaceHostRegion
日本www.amazon.co.jpwebservices.amazon.co.jpus-west-2
米国www.amazon.comwebservices.amazon.comus-east-1
英国www.amazon.co.ukwebservices.amazon.co.ukeu-west-1
ドイツwww.amazon.dewebservices.amazon.deeu-west-1

主要オペレーション

以下は旧PA-API 5向けの参考情報です。Creators APIの現在の仕様として流用しないでください。

オペレーション用途
SearchItemsキーワード/カテゴリ検索
GetItemsASIN 指定で個別取得(最大 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-sdk
use 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.0Sigv41 req/s〜アソシエイト連携前提
楽天市場 商品検索 APIApp ID1 req/s 目安アフィリエイト ID 任意
Yahoo!ショッピング APIYahoo! Client ID制限あり(公開値)商品検索 / カテゴリ取得
楽天ブックス/KoboApp 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 が違うとレコードゼロもよくあります。