Amazon.co.jp API：日本のストアの商品・価格・レビューを JSON に

amazon.co.jp で買い物客が目にしている情報を、そのまま JSON にして返す API です。検索結果の価格（円）、星の平均と評価数、「タイムセール」などの表示、ASIN ごとの商品ページ全体、同じ商品を売る出品者ごとの価格までを扱います。Amazon の公式 API である出品者向けの SP-API や、アソシエイト向けの Product Advertising API とは別物です。出品者アカウントもアソシエイト登録も要らない代わりに、注文や在庫の管理はできません。読み取り専用で、対象はサインインせずに見られる範囲の商品ページです。日本のストアを読むときは、すべてのリクエストに `"marketplace": "co.jp"` を付けてください。付け忘れると amazon.com が検索され、米ドルと英語の商品名が返ってきます。

動作する例

この電気ケトルは参考価格 6,428 円に対して 3,852 円（`discount_pct` 40）で、「タイムセール」の表示が付いていました。評価数 5,729 は検索結果のカードと商品ページで同じ値です。注意してほしいのは `bought_past_month` で、ページの表示は「過去1か月で 4000点以上購入されました」なのに、数値の欄は 1 になっています。文中で最初に出てくる「1か月」の 1 を拾ってしまう不具合で、直るまでは `bought_past_month_raw` の文字列から「点以上」の直前の数字を読んでください。

curl -X POST https://api.reefapi.com/amazon/v1/product/detail \
  -H "x-api-key: あなたのAPIキー" \
  -H "content-type: application/json" \
  -d '{"asin": "B0CG18ZM6J", "marketplace": "co.jp"}'

{
  "ok": true,
  "data": {
    "product": {
      "asin": "B0CG18ZM6J",
      "title": "SSYFEI 電気ケトル 1.0L【1000W急速沸騰・デジタル表示】7段階温度調節 4時間保温 二重構造で熱くない メモリー機能付 電気ポット",
      "brand": "SSYFEI",
      "price": 3852.0,
      "price_str": "￥3,852",
      "currency": "￥",
      "currency_code": "JPY",
      "list_price": 6428.0,
      "discount_pct": 40,
      "campaign": "タイムセール",
      "coupon": null,
      "rating": 4.4,
      "rating_count": 5729,
      "rating_histogram": { "5": 72, "4": 14, "3": 7, "2": 2, "1": 5 },
      "in_stock": true,
      "categories": ["ホーム＆キッチン", "家電", "キッチン家電", "電気ポット"],
      "fulfillment": "amazon",
      "bought_past_month_raw": "過去1か月で 4000点以上購入されました",
      "bought_past_month": 1,
      "upc": "716963913249",
      "tech_specs": {
        "品番・型番": "SF2094",
        "Amazon 売れ筋ランキング": "ホーム＆キッチン - 123位 ( ホーム＆キッチンの売れ筋ランキングを見る ) 電気ポット - 1位",
        ...
      },
      ...
    }
  },
  "meta": { "marketplace": "co.jp", "currency_code": "JPY", "record_count": 1, "charged_credits": 2, "cache_hit": false, "mode": "live" }
}

制限と正直な注記

• この API を作ったのは Amazon ではありません。アマゾンジャパンを含め、Amazon とは契約も提携もない第三者のサービスです。
• 既知の不具合：日本のストアでは `bought_past_month` が正しくありません。2026年10月26日、表示が「過去1か月で 3000点以上」「4000点以上」「400点以上」だった 3 商品で、数値はどれも 1 でした。修正までは `bought_past_month_raw` を使ってください。
• `marketplace` の既定値は `com` です。省略すると amazon.com の結果になり、価格は米ドル、商品名は英語です。`currency` は記号（￥）で、ISO コードは `currency_code`（JPY）に入ります。
• 日本のストアの `product/reviews` は、商品ページに載っているレビューだけを返します。評価数 17,168 件の電気ケトルで返ったのは 8 件でした（`stop_reason: inline_cap`）。その代わり `review_insights` に Amazon の AI 要約と、観点ごとの言及数（たとえば「価格」は 1,705 件の言及のうち 93% が好意的）が入っていました。
• 売れ筋ランキングの順位（「ホーム＆キッチン - 123位」など）は `tech_specs` の文字列の中にしかなく、調べた商品では `attributes.bsr` は null でした。`rating_histogram` は件数ではなく割合（%）です。
• 過去の価格は保存していません。返ってくるのは呼んだ瞬間の価格だけです。価格推移を追うなら、見たい ASIN を `products_batch`（1 回 40 件まで）で毎日決まった時刻に取り、自分のデータベースに積み上げてください。40 件を product/detail で 1 件ずつ取ると 80 クレジットですが、products_batch なら 10 クレジットです。
• `min_rating`、`deals`、`prime` の絞り込みは amazon.co.jp では測定していません。`prime` は Amazon 側に確実な絞り込みがないため、もともと目安です。バーコード検索は UPC で 1 件確認しました（JAN では未確認）。
• クレジット：search は Amazon から取得した検索結果ページ 1 枚ごとに 1 です。1 ページの件数はキーワードによって 16〜48 件ほどと変わるので、今回の「電気ケトル」20 件は 1 ページで済みましたが、336 件を頼むと最大 7 ページ分になります。product/detail と product/offers は 2、product/reviews と seller/reviews はレビュー 25 件ごとに 1（最低 1）、products_batch は 10、売れ筋と新着はランキングのページ（約 30 件）ごとに 1、そのほかは 1 回 1 です。