過去バージョン

このエラーの概要

Amazon Product Advertising API（PA-API、商品検索 API）を呼び出した際に返るエラー:

HTTP/1.1 400 Bad Request
<?xml version="1.0"?>
<ItemSearchErrorResponse xmlns="http://ecs.amazonaws.com/doc/2013-08-01/">
  <Error>
    <Code>AWS.MissingParameters</Code>
    <Message>Your request is missing required parameters. Required parameters
    include Operation.</Message>
  </Error>
</ItemSearchErrorResponse>

このエラーは PA-API リクエストに必須パラメータ Operation が含まれていない / 値が空のときに返されます。PA-API は SOAP/REST 由来の設計のため、すべてのリクエストに「何の処理を呼ぶか」を Operation で示す必要があります。

PA-API 4.0 と 5.0 の違い

対処1: PA-API 5.0 へ移行（必須）

2026 年現在、4.0 を呼んでも常にエラーになります。SDK 利用が公式推奨です:

# PHP
composer require amzn/paapi5-php-sdk

# Python
pip install paapi5-python-sdk

# Node.js
npm install paapi5-nodejs-sdk

# Java は Maven リポジトリから paapi5-java-sdk

対処2: PHP での正しい呼び出し（SearchItems）

<?php
require_once '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\PartnerType;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\SearchItemsRequest;
use Amazon\ProductAdvertisingAPI\v1\com\amazon\paapi5\v1\SearchItemsResource;

$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 GuzzleHttp\Client(), $config);

$request = new SearchItemsRequest();
$request->setPartnerTag('your-22');
$request->setPartnerType(PartnerType::ASSOCIATES);
$request->setKeywords('Python 入門');
$request->setSearchIndex('Books');
$request->setItemCount(10);
$request->setResources([
    SearchItemsResource::ITEM_INFOTITLE,
    SearchItemsResource::OFFERSLISTINGSPRICE,
    SearchItemsResource::IMAGESPRIMARYLARGE,
]);

try {
    $response = $apiInstance->searchItems($request);
    foreach ($response->getSearchResult()->getItems() as $item) {
        echo $item->getItemInfo()->getTitle()->getDisplayValue() . PHP_EOL;
    }
} catch (ApiException $e) {
    echo 'Error: ' . $e->getResponseBody();
}

対処3: 生 HTTP で呼ぶ場合（参考、SDK 推奨）

SDK を使わず直接呼ぶ場合、X-Amz-Target ヘッダに Operation を指定します:

POST /paapi5/searchitems HTTP/1.1
Host: webservices.amazon.co.jp
Content-Type: application/json; charset=UTF-8
X-Amz-Date: 20260515T120000Z
X-Amz-Target: com.amazon.paapi5.v1.ProductAdvertisingAPIv1.SearchItems
Authorization: AWS4-HMAC-SHA256 Credential=...

{
  "Keywords": "Python 入門",
  "SearchIndex": "Books",
  "ItemCount": 10,
  "PartnerTag": "your-22",
  "PartnerType": "Associates",
  "Marketplace": "www.amazon.co.jp",
  "Resources": [
    "ItemInfo.Title",
    "Offers.Listings.Price"
  ]
}

PA-API 5.0 で使える Operation 一覧

よくある原因と対処

FAQ

Q: PA-API 4.0 をまだ使えるか？
A: 使えません。2020 年 3 月で完全廃止。今 4.0 を呼ぶと 400 エラーや 410 Gone が返ります。

Q: 売上 0 でも開発できる？
A: PA-API はアフィリエイト売上が条件。30 日以内に 3 件以上の発注がないと API キーが停止されます。開発用には Amazon Sandbox（提供地域限定）または アソシエイト・セントラルのテスト機能を使用。

Q: 日本 Amazon と米国 Amazon で同じキーは使える？
A: アソシエイト ID はマーケットプレイスごとに別。Host も webservices.amazon.co.jp / webservices.amazon.com と分けます。

関連エラー

• The request signature we calculated does not match — 署名ミス、SDK 利用推奨
• AssociateTag not found — PartnerTag 誤り、コンソールで確認
• InvalidParameterValue: ItemIds — ASIN が無効 / 商品削除済