API Description

The Revenue Calculator API connects directly to Amazon’s official fee service. Given a product ASIN and a target marketplace, it returns a fee breakdown for both FBA (Fulfilled by Amazon) and MFN (Merchant Fulfilled) modes — including the fulfillment fee, referral fee, and monthly storage fee — to support product sourcing and profit estimation.
You can pass just asin + country to use smart defaults (the product’s current price, dimensions, and weight are applied automatically), or override the sale price, shipping cost, package dimensions, and weight to model your exact cost structure.

🤖 Pulling this data to power an AI Agent? Instead of writing custom parsing code, leverage our MCP Server to grant your AI workspace native, real-time access to Amazon fee estimation with zero integration friction.

Request URL

POST https://scrapeapi.pangolinfo.com/api/v1/revenue-calculator

Request Headers

ParametersParameter valueTypeDescription
Content-Typeapplication/jsonstringData format
AuthorizationBearer xxxstringAuthorization Token

Request Parameters

ParameterRequiredTypeDescription
asinYesstringProduct ASIN, matching the product entered in the search box at the top of the web page
countryYesstringMarketplace country: US / JP (case-insensitive), matching the Marketplace selector at the top-right of the web page (Amazon.com / Amazon.co.jp)
fbaPriceNonumberFBA (Fulfilled by Amazon) sale price. Matches the “Item price” under “Amazon fulfillment (FBA)”. Defaults to the product’s current price
mfnPriceNonumberMFN (Merchant Fulfilled) sale price. Matches the “Item price” under “Your fulfillment (MFN)”. Defaults to the product’s current price
mfnShippingPriceNonumberMFN (Merchant Fulfilled) shipping cost paid by the buyer. Matches the “Shipping cost” under “Your fulfillment (MFN)”. Defaults to 0
packageLengthNonumberPackage length. Matches “Length” under “Product dimensions”. Defaults to the product’s dimensions
packageWidthNonumberPackage width. Matches “Width” under “Product dimensions”. Defaults to the product’s dimensions
packageHeightNonumberPackage height. Matches “Height” under “Product dimensions”. Defaults to the product’s dimensions
dimensionUnitNostringDimension unit: inches / centimeters. Defaults to inches for US and centimeters for JP
packageWeightNonumberPackage weight. Matches “Unit weight”. Defaults to the product’s weight
weightUnitNostringWeight unit: pounds / kilograms. Defaults to pounds for US and kilograms for JP
programsNoarray<string>Fulfillment programs to calculate: FBA / MFN. Both are calculated when omitted

Response

The returned data contains three parts: product (product info), summary (fee summary), and raw (Amazon’s original fee breakdown).

data.summary — Fee Summary

FieldTypeDescription
FBA.fulfillmentFeenumberFBA fulfillment fee (not present for MFN)
FBA.referralFeenumberFBA referral fee, net (promotion already deducted; a percentage of the sale price — when no sale price is provided it is computed against the fallback price of 1, so it will be very small)
FBA.referralFeeBasenumberBase referral fee (before promotion deduction; present even when 0 — only omitted if Amazon does not return this fee item)
FBA.referralFeePromotionnumberReferral fee promotion discount (0 when none; only omitted if Amazon does not return this fee item)
FBA.fixedClosingFeenumberFixed closing fee (applies to media products, usually 0 otherwise; only omitted if Amazon does not return this fee item)
FBA.amazonFeeTotalnumberAmazon fee total = base referral fee + fixed closing fee (matches the “Amazon fees” row on the official site)
FBA.storageFeePeaknumberPeak-season monthly storage fee (per unit)
FBA.storageFeeNonPeaknumberOff-peak monthly storage fee (per unit)
FBA.totalCostnumberFBA total = fulfillment fee + net referral fee + fixed closing fee (storage fee excluded, listed separately)
FBA.profitnumberNet profit = price − (totalCost + off-peak storage fee), matches the official “Net profit” row. When fbaPrice is not provided and the product’s current price cannot be fetched, price falls back to 1, making profit mostly negative and meaningless — always pass a real fbaPrice to estimate profit
FBA.profitRatenumberNet profit margin (%) = profit / price × 100 (2 decimals), matches the official “Net margin” row. Meaningless under the fallback price of 1, same as profit
FBA.currencystringCurrency (USD for US, JPY for JP)
MFN.referralFeenumberMFN net referral fee
MFN.referralFeeBasenumberBase referral fee (same as FBA)
MFN.referralFeePromotionnumberReferral fee promotion discount (same as FBA)
MFN.fixedClosingFeenumberFixed closing fee (same as FBA)
MFN.amazonFeeTotalnumberAmazon fee total = base referral fee + fixed closing fee
MFN.totalCostnumberMFN total = net referral fee + fixed closing fee (no storage fee for self-fulfillment)
MFN.profitnumberNet profit = price − totalCost (no storage for self-fulfillment). Meaningless under the fallback price of 1, same as FBA.profit
MFN.profitRatenumberNet profit margin (%) = profit / price × 100 (2 decimals). Same as profit
MFN.currencystringCurrency

data.product — Product Info

FieldTypeDescription
asinstringProduct ASIN
pricenumberThe sale price actually used for calculation (the fbaPrice value when provided, otherwise the product’s current price; falls back to 1 when neither is available). Matches the “Item price” input on the official site
titlestringProduct title
imageUrlstringProduct main image URL
glProductGroupNamestringProduct group / category (Amazon internal classification)
salesRankintSales rank (may be null for some products)
dimensionobjectDimensions, containing length, width, height, unit. Note: Amazon’s anonymous fee API does not return product dimensions, so length/width/height are always 0 unless you pass packageLength/Width/Height (Amazon uses its internal dimensions to compute the fulfillment fee but does not return them here). Pass the parameters to estimate by real dimensions
weightobjectWeight, containing value, unit. Same as dimensions — value is always 0 unless packageWeight is provided. Pass packageWeight to estimate by real weight

data.raw — Amazon Original Fee Breakdown

FieldTypeDescription
rawobjectThe complete original payload from Amazon’s fee service, containing every fee item under programFeeResultMap (Core#0 for FBA, MFN#1 for MFN) — including optional fees not rolled up into summary, such as bubble-wrap, labeling, and removal fees. Use this node when you need finer-grained fee items.

Request Example

curl https://scrapeapi.pangolinfo.com/api/v1/revenue-calculator \
  --request POST \
  --header 'Authorization: ' \
  --header 'Content-Type: application/json' \
  --data '{
  "asin": "B07FZ8S74R",
  "country": "US",
  "fbaPrice": 49.99
}'

Response Example

The example below passes fbaPrice: 49.99, so referral fee, net profit, and margin are all meaningful real values. referralFee (net) = referralFeeBasereferralFeePromotion; amazonFeeTotal = referralFeeBase + fixedClosingFee; totalCost includes fixedClosingFee; profit = price − (totalCost + storageFeeNonPeak) (MFN has no storage).

{
  "code": 0,
  "message": "ok",
  "data": {
    "summary": {
      "FBA": {
        "fulfillmentFee": 5.62,
        "referralFee": 7.50,
        "referralFeeBase": 7.50,
        "referralFeePromotion": 0.0,
        "fixedClosingFee": 1.80,
        "amazonFeeTotal": 9.30,
        "storageFeePeak": 0.78,
        "storageFeeNonPeak": 0.39,
        "totalCost": 14.92,
        "profit": 34.68,
        "profitRate": 69.37,
        "currency": "USD"
      },
      "MFN": {
        "referralFee": 7.50,
        "referralFeeBase": 7.50,
        "referralFeePromotion": 0.0,
        "fixedClosingFee": 1.80,
        "amazonFeeTotal": 9.30,
        "totalCost": 9.30,
        "profit": 40.69,
        "profitRate": 81.40,
        "currency": "USD"
      }
    },
    "product": {
      "asin": "B07FZ8S74R",
      "price": 49.99,
      "title": "Echo Dot (3rd Gen, 2018 release) - Smart speaker with Alexa - Charcoal",
      "imageUrl": "https://m.media-amazon.com/images/I/41CRnvYqmqL._SL120_.jpg",
      "glProductGroupName": "gl_digital_products_3",
      "salesRank": null,
      "dimension": { "length": 0.0, "width": 0.0, "height": 0.0, "unit": "inches" },
      "weight": { "value": 0.0, "unit": "pounds" }
    },
    "raw": {
      "countryCode": "US",
      "asin": "B07FZ8S74R",
      "programFeeResultMap": {
        "Core#0": { "otherFeeInfoMap": { "FulfillmentFee": { "total": { "amount": 5.62, "currency": "USD" } }, "ReferralFee": { "total": { "amount": 7.50, "currency": "USD" } } } },
        "MFN#1": { "otherFeeInfoMap": { "ReferralFee": { "total": { "amount": 7.50, "currency": "USD" } } } }
      }
    }
  }
}

Custom Price & Dimensions Example

When fbaPrice is provided, the referral fee is recalculated based on the sale price:

curl https://scrapeapi.pangolinfo.com/api/v1/revenue-calculator \
  --request POST \
  --header 'Authorization: ' \
  --header 'Content-Type: application/json' \
  --data '{
  "asin": "B07FZ8S74R",
  "country": "US",
  "fbaPrice": 49.99,
  "packageWeight": 1.2,
  "weightUnit": "pounds"
}'

Credit Consumption

  • Average response time: US 3~5s, JP 5~15s
  • Credit consumption: 5 credits/request

Send requests serially to avoid rate limiting. This API connects directly to Amazon’s official fee service, which rate-limits by source IP with a relatively low threshold. High concurrency (QPS ≥ 3) triggers rate limiting and returns 4030 (service busy) or 1002 (system busy). Call serially and keep the request rate low; if you hit these codes, simply retry after a short wait (rate-limited failures do not consume credits).