1.

Amazon旧PA-APIのキー取得記録とCreators APIの登録確認

▶

Amazonの商品APIの認証情報は、利用するAPI世代を決めてから取得します。旧PA-APIの画像・コードを現行の発行手順と取り違えないため、現在の登録と旧記録を分けて説明します。

旧ItemSearchとPA-API5、後継Creators APIの違い

先に確認: 旧PA-APIと現在のCreators API

2026年10月確認。PA-API 5.0も公式の廃止案内の対象です。このページの旧PA-API例は保守・比較用で、現在の新規導入手順ではありません。旧APIの403をキー再発行や再試行だけで直そうとしないでください。

後継への移行は公式移行ガイドを確認します。旧AWSキーとSigV4ではなく、Creators API用のCredential ID / Secret / VersionとOAuth 2.0を使います。本文の旧フィールド名・旧SDKをそのまま現行APIへ適用しないでください。親のPA-APIの関連資料から各子ページも選択できます。

現在の登録前チェック

  1. 対象国のアソシエイトアカウントと承認状態を確認する。Amazonの買い物用アカウント、サイト審査、API資格は同一条件ではない。
  2. 公式登録手順で、対象ストアと主アカウント所有者の権限を確認する。
  3. Tools → Creators APIでアプリケーションを作り、Credential ID / Secret / Versionを安全に保管する。Versionを旧PA-APIのRegionで代用しない。
  4. Partner Tag・Marketplaceも対象ストアと照合し、秘密情報をブラウザーへ送らずサーバー側の設定で管理する。
  5. 導入時は現行SDKの配布と認証を確認する。この記事の旧SDKをインストールして動作確認しない。

漏洩時は履歴編集より資格情報の無効化を優先します。Git履歴から消しても、既存のcloneや配布物から秘密値を回収できた保証にはなりません。

この記事の要点
  • Step 1: Amazon アソシエイト・プログラム参加(サイト・SNS 審査あり)
  • Step 2: アソシエイト管理画面 → ツール → Product Advertising API
  • Step 3: 認証情報を追加から Access Key ID / Secret Access Key 発行(Secret は初回しか表示されないのでコピー必須)
  • パートナータグ (xxx-22 等) は審査通過時に付与されるアソシエイト ID。リクエストに必須
  • アソシエイトの申請審査とAPI利用資格は別。売上条件だけで承認や旧APIの継続利用を保証しない
  • 以下は旧PA-API 5のAWS SigV4方式の記録。現在のSDK配布・OAuth認証はCreators API公式資料を確認

全体の流れ

次の5項目は旧PA-API時代の流れを読むために保持しています。現在の登録では、この直前のCreators API案内と以下の新しい確認手順を優先してください。

  1. Amazon アソシエイト・プログラムへ登録 (サイト or SNS チャネルが必要)
  2. 申請審査。適格売上の条件を満たしても、サイト内容等の審査通過を自動保証しない
  3. アソシエイト管理画面から PA-API 用認証情報を発行
  4. Access Key ID / Secret Access Key / パートナータグの 3 点セットを取得
  5. SDK や HTTP クライアントから署名付きリクエストで API 呼出

Step 1: Amazon アソシエイト登録

  1. Amazon アソシエイト にアクセス
  2. 通常の Amazon アカウントでログイン
  3. アカウント情報・支払先・サイトまたは SNS の URL を入力
  4. 運営サイトの内容についての質問に回答(ジャンル・収益化方法)
  5. アソシエイト ID (例: xxxxxx-22) を選ぶ → 登録完了

Amazonの申請審査の公式説明は、登録後180日以内に3件以上の適格売上が必要で、自己注文は対象外としています。これは審査条件であり、達成だけで承認確定・API利用確定とは扱いません。対象地域の案内を確認してください。

Step 2: PA-API 用の認証情報発行

以下の画面手順・後方の参考画像は旧PA-APIの記録です。 現行画面の保証ではありません。Creators APIではToolsから対象サービスを開き、アプリケーションと専用資格情報を登録します。旧キーを作り直して移行しないでください。

  1. アソシエイト管理画面にログイン
  2. 上部メニューから ツール → Product Advertising API
  3. 認証情報を追加する ボタンをクリック
  4. 「認証情報を追加しました」画面で:
    • アクセスキー (Access Key ID)
    • シークレットキー (Secret Access Key) — この画面でしか確認できない。閉じると二度と取り出せず再発行のみ
    • 認証情報を CSV でダウンロードボタンで保存推奨
  5. パートナータグはアソシエイト ID (例 yourid-22) と同じ

取得する 3 つの値

項目例用途
Access Key IDAKIAxxxxxxxxxxxxxxxx旧署名の識別子。Secretとは別だが、不要に公開せずサーバー側で管理する
Secret Access KeywJalrXUtnFEMI/K7MDENG/...絶対秘匿。署名生成用
パートナータグyourid-22リクエストに必須。報酬の紐付け

マーケットプレースも確認します。次表は旧PA-APIのホスト/リージョンであり、Creators APIの送信先ではありません:

マーケットプレースホストリージョン
日本webservices.amazon.co.jpus-west-2
米国webservices.amazon.comus-east-1
英国webservices.amazon.co.ukeu-west-1
ドイツwebservices.amazon.deeu-west-1

Step 3: SDK でテストリクエスト

下のComposerコマンド・旧SDKコードは実行を勧めない原資料です。 パッケージ名・現在の配布や実行成功を検証していません。旧コードはnull参照や生の例外/レスポンス出力を含み、安全な完成実装ではありません。実値を埋め込んだりブラウザーで秘密情報を表示したりしないでください。

# PHP SDK
composer require amzn/paapi5-php-sdk
<?php
require __DIR__ . '/vendor/autoload.php';

use Amazon\ProductAdvertisingAPI\v1\ApiException;
use Amazon\ProductAdvertisingAPI\v1\Configuration;
use Amazon\ProductAdvertisingAPI\v1\api\DefaultApi;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\SearchItemsRequest;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\PartnerType;
use GuzzleHttp\Client;

$config = new Configuration();
$config->setAccessKey('YOUR_ACCESS_KEY');
$config->setSecretKey('YOUR_SECRET_KEY');
$config->setHost('webservices.amazon.co.jp');
$config->setRegion('us-west-2');

$apiInstance = new DefaultApi(new Client(), $config);

$req = new SearchItemsRequest();
$req->setSearchIndex('All');
$req->setKeywords('Kindle');
$req->setItemCount(3);
$req->setPartnerTag('yourid-22');
$req->setPartnerType(PartnerType::ASSOCIATES);
$req->setResources(['ItemInfo.Title', 'Offers.Listings.Price']);

try {
    $resp = $apiInstance->searchItems($req);
    foreach ($resp->getSearchResult()->getItems() as $item) {
        echo $item->getASIN() . ' — '
           . $item->getItemInfo()->getTitle()->getDisplayValue() . "\n";
    }
} catch (ApiException $e) {
    echo "Error: " . $e->getMessage() . "\n";
    echo $e->getResponseBody();
}

180 日 / 3 件売上ルール

以下はアソシエイトの審査条件とAPI利用資格を混同しないための確認です:

  • アソシエイト登録初日から180 日 (約 6 ヶ月)がカウント開始
  • この期間中に 3 件以上の適格売上(自分以外の購入者によるアソシエイトリンク経由購入)が必要
  • 売上条件を満たした後もサイト等の審査がある。旧PA-APIの継続利用を保証しない
  • 未達成時の申請状態・再申請は対象地域の公式案内で確認する
  • 失効後の再登録は可能。アカウントは Amazon 利用そのものとは別

旧PA-APIへの新規導入を進めるのではなく、現在は次の順に確認します:

  1. 通常のアソシエイト参加・審査条件を確認する。購入の依頼・自己購入を条件達成策として勧めない
  2. Creators APIの登録資格、対象ストアと管理権限を公式案内で確認する
  3. APIごとの現在の利用枠を確認し、旧PA-APIの数値や単純な呼出回数から推測しない

キー漏洩時の対処

  1. まず漏洩した資格情報を対象サービスの管理画面で無効化する。旧PA-APIキーとCreators API資格情報のどちらかを特定する
  2. 影響範囲を確認し、必要な現行サービスの資格情報へ更新する。旧PA-APIの再発行で廃止問題を直そうとしない
  3. git にコミットしてしまった場合は git filter-repo や BFG Repo-Cleaner で履歴から除去
  4. 環境変数 or .env 管理に変更(.gitignore 必須)

レート制限

  • 旧PA-APIの初期枠の数字を現在のCreators APIへ流用しない
  • 売上と枠の換算を日本円1円ごとの固定ルールと断定しない。現行の対象地域・アカウントの案内を確認
  • 利用資格とレート枠を分けて確認する。認証失敗を枠不足と即断しない
  • 枠を超えると TooManyRequests (429) エラー

FAQ

Q: シークレットキーをメモし忘れた
A: Creators APIのSecretは作成時に安全に保存します。紛失した場合の新規資格情報の生成は公式手順を確認してください。CSVも秘密ファイルとして扱い、公開ディレクトリや共有Gitへ置きません。

Q: パートナータグを複数持てる?
A: 可能。サイト別に siteA-22 / siteB-22 等を発行し、リクエストの PartnerTag で切替。レポートも分かれる。

Q: 売上 3 件が間に合わない
A: 「努力義務」や知人への購入依頼でよいとは扱いません。対象地域の審査・再申請条件を確認し、自己注文やインセンティブを使う条件達成策は勧めません。API利用資格とは別に確認してください。

📸 参考画像

※ 旧バージョンから引き継いだ参考画像です。手順・図解の補助としてご覧ください。

参考画像

参考画像

子ページ

子ページはありません

同階層のページ
  1. アカウントの作成とキーの生成
  2. PA-APIの使い方 リクエストの構造とパラメータの指定
  3. リクエストにスペースを含める方法
  4. 署名認証の方法(PHPサンプル ItemSearch)
  5. エラー一覧
  6. レスポンスの構造(ItemSearch)

最近更新/作成されたページ