この記事でわかること：SellerSprite FBA料金計算APIで取得できるデータの種類、Web計算機とAPIの使い分け、必須入力項目（寸法・価格・原価など）、リクエストとレスポンスの実装例、手数料・利益率の計算式、市場別料金と適用日の扱い方、一括処理とエラー対応までを解説します。
複数商品のFBA採算を継続的に評価したい開発者や運用担当者に向けて、SellerSprite FBA料金計算APIの具体的な使い方を解説します。本APIでは、商品の寸法・価格・原価などの入力情報をもとに、FBA手数料、紹介料、配送料、純利益、利益率などを自動計算できます。料金改定時に結果を追跡できるよう、適用市場と料金表のバージョンも明示しながら、実装例を紹介します。
1. Web計算機とAPIの使い分け
SellerSpriteは、FBA料金計算に関してWeb版の利益計算機とAPIの2つのインターフェースを提供しています。目的に応じて適切に使い分けることが重要です。
| 比較項目 | Web版利益計算機 | FBA料金計算API |
|---|
| 主な用途 | 単一商品の簡易採算確認・アイデア検証 | 複数商品の継続的な採算評価・システム連携 |
| 入力方法 | ブラウザ上で手動入力 | プログラムからJSONで送信 |
| 処理可能な商品数 | 1商品ずつ | 一括処理（バッチ）が可能 |
| 自動化 | 不可（手動操作が必要） | 可能（定期実行・トリガー連携） |
| 推奨ユーザー | 初心者・少品目セラー | 開発者・大規模セラー・エージェンシー |
Web版の利益計算機はFBA利益計算機のご利用ガイドで詳しく紹介されています。APIは、定期的な採算評価の自動化や、自社システムへの組み込みを目的とする場合に適しています。
FBA料金計算APIで正確な結果を得るためには、以下の入力項目を正しく設定する必要があります。
必須入力項目
- 商品寸法（Package Dimensions）：縦・横・高さ（cmまたはinch）
- 商品重量（Package Weight）：商品の重量（gまたはoz）
- 販売価格（Selling Price）：設定予定の販売価格（通貨指定）
- 仕入れ原価（Manufacturing Cost）：商品1個あたりの仕入れコスト
- マーケットプレイス（Marketplace）：販売予定のAmazonサイト（JP / US / UK / DE / FR / IT / ES / CA / MX / AU）
- カテゴリ（Category）：商品が属するAmazonカテゴリ（手数料率が異なるため重要）
オプション入力項目
- 配送方法（Fulfillment Type）：FBA / FBM（自己発送）の選択
- 返品率（Return Rate）：予想される返品率（デフォルトは0%）
- PPC予算（PPC Budget）：広告費の見込み額
- その他コスト（Other Costs）：ラベリング費・通関費など
寸法・重量の正確性が重要：FBA手数料は商品のサイズ区分と重量によって大きく変動します[reference:0]。寸法や重量の入力が不正確だと、実際の手数料と大きく乖離する可能性があります。実測値を基に入力してください。
3. リクエストとレスポンス
以下は、FBA料金計算APIのリクエストとレスポンスの例です。
curl -X POST "https://api.sellersprite.com/v1/fba/calculate" \ -H "X-API-Key: your_api_key_here" \ -H "Content-Type: application/json" \ -d '{ "marketplace": "JP", "category": "Electronics", "selling_price": 5980, "manufacturing_cost": 1200, "package_dimensions": { "length": 25, "width": 18, "height": 5, "unit": "cm" }, "package_weight": { "value": 350, "unit": "g" }, "return_rate": 0.05, "ppc_budget": 500 }'
{ "code": 200, "data": { "marketplace": "JP", "category": "Electronics", "selling_price": 5980, "manufacturing_cost": 1200, "fees": { "referral_fee": 898, "fba_fee": 420, "storage_fee": 15, "total_fees": 1333 }, "profit": { "gross_profit": 4780, "net_profit": 3447, "profit_margin": 57.6, "roi": 187.3 }, "break_even": { "break_even_price": 2533, "break_even_acOS": 25.4 }, "fee_version": "2026-09", "calculated_at": "2026-09-04T09:00:00+09:00" }, "request_id": "req_fba_xyz789" }
レスポンスに含まれる主なフィールドの説明：
- referral_fee（紹介料）：Amazonに支払う成約料（カテゴリごとに異なる率で計算）
- fba_fee（FBA手数料）：配送代行手数料（サイズ・重量に基づく）
- storage_fee（保管料）：月間の在庫保管料（推定値）
- net_profit（純利益）：販売価格から全費用（仕入れ・手数料・広告・返品）を差し引いた最終利益
- profit_margin（利益率）：販売価格に対する純利益の割合（%）
- roi（投資利益率）：仕入れ原価に対する利益の割合（%）
- break_even_price（損益分岐点価格）：利益がゼロになる販売価格
- fee_version（料金バージョン）：計算に使用したAmazon料金表のバージョン
FBA料金計算APIが内部的に使用している主要な計算式を以下に示します。
紹介料（Referral Fee）
紹介料 = 販売価格 × カテゴリ別紹介料率（8%〜15%）
カテゴリによって紹介料率が異なります（例：家電・カメラは8%、ファッションは10%など）。APIは指定されたカテゴリに基づいて自動的に適用されます。
FBA手数料（FBA Fee）
FBA手数料 = サイズ区分に基づく基本料金 + 重量に基づく追加料金
Amazonは商品のサイズ区分（Small / Standard / Large / Oversizeなど）と重量に基づいてFBA手数料を設定しています[reference:1]。APIは入力された寸法・重量から自動的にサイズ区分を判定し、対応する料金を適用します。
純利益（Net Profit）
純利益 = 販売価格 − 仕入れ原価 − 紹介料 − FBA手数料 − 保管料 − PPC費用 − 返品損失
利益率（Profit Margin）
利益率（%） = 純利益 ÷ 販売価格 × 100
ROI（投資利益率）
ROI（%） = 純利益 ÷ 仕入れ原価 × 100
計算例（家電カテゴリ・日本市場）
- 販売価格：5,980円
- 仕入れ原価：1,200円
- 紹介料（8%）：478円
- FBA手数料（標準サイズ）：420円
- 保管料（推定）：15円
- PPC費用（推定）：500円
- 返品損失（5%想定）：299円
- 純利益：5,980 − 1,200 − 478 − 420 − 15 − 500 − 299 = 3,068円
- 利益率：3,068 ÷ 5,980 × 100 = 51.3%
- ROI：3,068 ÷ 1,200 × 100 = 255.7%
5. 市場別料金と適用日
FBA料金はマーケットプレイスごとに異なり、かつ定期的に改定されます[reference:2]。APIを利用する際は以下の点に注意してください。
- 市場別の料金体系：日本（JP）、アメリカ（US）、イギリス（UK）、ドイツ（DE）、フランス（FR）、イタリア（IT）、スペイン（ES）、カナダ（CA）、メキシコ（MX）、オーストラリア（AU）の各市場で、FBA手数料・紹介料・保管料が異なります。
- 料金改定への対応：Amazonは毎年春（2月〜4月頃）と秋（9月〜11月頃）にFBA手数料を改定することが一般的です[reference:3]。APIレスポンスには
fee_version フィールドが含まれており、どの料金表で計算されたかを追跡できます。 - 季節変動への対応：一部の市場では繁忙期（特に年末商戦期）にFBA手数料が変動する場合があります[reference:4]。APIは最新の料金表を反映しています。
料金改定時の注意：料金改定後は、過去の計算結果と新しい計算結果を比較する際に同じ料金バージョンで比較することが重要です。APIレスポンスの fee_version を必ず記録し、分析時に参照してください。
6. 一括処理とエラー対応
複数商品の採算を一括で評価するための実装パターンと、エラー対応のポイントを紹介します。
一括処理の実装パターン
- チャンク分割：一度に処理する商品数を一定数（例：50件）に分割し、段階的に処理する
- 非同期処理：キュー（Redis / SQSなど）を用いて非同期で処理し、結果をデータベースに保存する
- ステータス管理：各商品の処理状態（未処理・処理中・完了・エラー）を管理する
import requests import time API_KEY = "your_api_key_here" API_URL = "https://api.sellersprite.com/v1/fba/calculate" def calculate_fba_profit(product_data): headers = {"X-API-Key": API_KEY, "Content-Type": "application/json"} try: response = requests.post(API_URL, json=product_data, headers=headers, timeout=30) response.raise_for_status() return response.json() except requests.exceptions.RequestException as e: return {"error": str(e), "product": product_data} def batch_calculate(products, chunk_size=50): results = [] for i in range(0, len(products), chunk_size): chunk = products[i:i + chunk_size] for product in chunk: result = calculate_fba_profit(product) results.append(result) time.sleep(0.2) return results products = [ { "marketplace": "JP", "category": "Electronics", "selling_price": 5980, "manufacturing_cost": 1200, "package_dimensions": {"length": 25, "width": 18, "height": 5, "unit": "cm"}, "package_weight": {"value": 350, "unit": "g"} } ] results = batch_calculate(products)
エラー対応のポイント
- 入力バリデーション：APIリクエスト前に必須項目がすべて揃っているか、数値が正しい範囲内かを検証する
- レート制限への対応：429エラーが発生した場合は指数バックオフで再試行する
- エラーログの記録：エラーが発生した商品のASINや入力内容をログに記録し、後で調査できるようにする
- 部分的成功の許容：バッチ処理の一部がエラーになっても、成功した分はデータベースに保存し、エラー分は後で再処理する設計にする
よくある質問（FAQ）
Web版のFBA利益計算機とAPIは同じ計算ロジックを使っていますか？
はい、同じ計算エンジンを使用しています。Web版とAPIは共通の料金データベースと計算ロジックを共有しているため、同じ入力値に対して同じ結果が得られます[reference:5]。APIはWeb版と同じ精度を保ちながら、プログラムからの自動実行を可能にしています。
FBA料金計算APIで対応しているマーケットプレイスはどこですか？
日本（JP）、アメリカ（US）、イギリス（UK）、ドイツ（DE）、フランス（FR）、イタリア（IT）、スペイン（ES）、カナダ（CA）、メキシコ（MX）、オーストラリア（AU）の10のマーケットプレイスに対応しています。各市場のFBA料金体系は異なるため、marketplaceパラメータを正しく指定してください。
FBA料金が改定された場合、APIは自動的に最新料金を反映しますか？
はい、Amazonの公式料金改定後、速やかに最新料金が反映されます[reference:6]。APIレスポンスには fee_version フィールドが含まれており、どの料金表で計算されたかを確認できます。過去の計算結果と比較する際は、同じ料金バージョンで比較することをおすすめします。
バリエーション商品（サイズ違い・カラー違い）の採算はどうやって計算すればいいですか？
バリエーションごとに寸法・重量・価格が異なる場合は、それぞれ個別のリクエストを送信してください。バリエーション間で仕入れ原価や販売価格が異なる場合は、それらを区別して入力することで、各バリエーションごとの正確な採算を計算できます。
FBA料金計算APIの結果は実際のAmazon請求とどの程度一致しますか？
APIはAmazonの公式料金表に基づいて計算を行っていますが、実際の請求には以下の要因で差異が生じる可能性があります。①実際の商品寸法・重量が入力値と異なる場合 ②返品・補償事由による追加費用 ③プロモーション・クーポンによる価格変動 ④長期保管料などの追加費用。APIの結果は「見込み値」として捉え、実際の請求書と定期的に照合することをおすすめします。
著者：セラースプライト(SellerSprite) 編集部
Amazon外部サービスプロバイダー(Amazon SPN)として、Amazon市場向けのリサーチツールを提供している私たちは、日々変化するAmazon市場において、セラーの皆様が抱える「何が売れるのか？」「どうすれば利益を出せるのか？」という悩みを解決するための情報を発信しています。
私たちは単なるツールの提供者ではなく、伴走型パートナーとしてセラー様と一緒に成長しようと考えています。
EC事業者やこれから物販ビジネスを始める方に向けて、実用的な情報をお届けしています。