楽天商品検索 API（2026-07-01 版）に移るときの対処：アクセスキーと Referer が必須、エラーの形式もドキュメントと違う

2026年10月14日

楽天商品検索 API の 2026-07-01 版では、アプリ ID に加えてアクセスキーが必須です。私の環境では、Referer ヘッダーがないとエラーになりました。 エラーの応答も、ドキュメントに書かれた形とは違う形で返ってきたので、両方に対応しておかないと「該当商品なし」に化けます。

解決方法

エンドポイントは openapi.rakuten.co.jp に移っています

https://openapi.rakuten.co.jp/ichibams/api/IchibaItem/Search/20260701

applicationId と accessKey の両方を送る。accessKey は、ドキュメントではヘッダーでもクエリでもよいとされています。URL やアクセスのログに残さないよう、私はヘッダーで送っています
Referer ヘッダーを付ける（WordPress から呼ぶなら、サイトの URL）
エラーは、ドキュメントの形（error と error_description）と、実際に返ってきた形（errors の中の errorCode と errorMessage）の両方を見る

WordPress から呼ぶなら、次のような形です。

$response = wp_remote_get(
    add_query_arg(
        array(
            'applicationId' => $application_id,
            'keyword'       => $keyword,
            'format'        => 'json',
        ),
        'https://openapi.rakuten.co.jp/ichibams/api/IchibaItem/Search/20260701'
    ),
    array(
        'headers' => array(
            'accessKey' => $access_key, // URL に残さないようヘッダーで送る
            'Referer'   => home_url(),
        ),
        'timeout' => 15,
    )
);

$body = json_decode( wp_remote_retrieve_body( $response ), true );
// エラーは2つの形のどちらでも返ってくる
$error = $body['errors']['errorMessage'] ?? $body['error_description'] ?? $body['error'] ?? null;
if ( is_wp_error( $response ) || wp_remote_retrieve_response_code( $response ) >= 400 || $error ) {
    // 「該当商品なし」にせず、エラーとして画面に出す
}

起きたこと

WordPress のプラグインから楽天の商品検索 API を呼んで、商品のリンクと画像を入れる機能を作っていました。2026-07-01 版に移ると、次の順番でつまずきました。

アクセスキーが必須になっていた：アプリ ID だけでは通らなくなっていました
Referer ヘッダーもないと通らなかった：REQUEST_CONTEXT_BODY_HTTP_REFERRER_MISSING というエラーで気づきました。公式のドキュメントには、Referer についての記載は見つかりませんでした
エラーが「該当商品なし」に化けていた：ドキュメントにある error の形しか見ていなかったので、errors の形で返ってきたキーの誤りなどが素通りして、「該当する商品が見つかりませんでした」と表示されていました