1. Home
  2. Docs
  3. Amzpecty Documentation
  4. Amzpecty API Specifications
  5. Estimate Profit API

Estimate Profit API

ADD ASIN/ISBN TO ESTIMATE PROFIT QUERY QUEUE

The request to add an ASIN/ISBN to Estimate Profit query queue.

CREDIT DEDUCTION

1 (one) credit deduction after successful retrieval of MFN and FBA data.

Additional 1(one) credit deduction for each of the following optional parameters.

  • includefbalight – (optional boolean) – if true will include FBA Small and Light
  • includeefn – if true will include European Fulfillment Network (EFN)
  • includepaneu – if true will include PAN – European FBA
  • includepaneulight – if true will include PAN – European FBA Small and Light
REQUEST
URI /api/query/estprofit/{ASIN/ISBN}?sellingprice={sellingprice}&myfbacost={myfbacost}&mymfncost={mymfncost}&domain={domain}&secretKey={secretKey}&serviceaddons=inventoryplacement,opaquebagging,tape,label,bagging,bubblewrap&peakstorage=true {ASIN/ISBN} – required – the ASIN or ISBN to add to estimate profit query queue
{sellingprice} – numeric | required – The target selling price of the ASIN
{myfbacost} – numeric | optional – The total FBA fulfillment cost of the seller excluding Amazon Fees. Defaults to 0.00 if unspecified.
{mymfncost} – numeric | optional – The total MFN fulfillment cost including Shipping Charges, Labor, Packing Materials, Shipping To Customer, Customer Service, Storage Cost and other Cost of the seller excluding Amazon Fees. Defaults to 0.00 if unspecified.
{serviceaddons} –optional – Fulfillment Cost Service Add-ons. Comma separated valid values [ inventoryplacement,opaquebagging,tape,label,bagging,bubblewrap ]. Service add-ons are off by default unless specified on this parameter value.
{peakstorage} – boolean | optional – Flag to indicate use of peak storage cost. Defaults to false if unspecified.
{includefbalight} – boolean | optional – if true will include FBA Small and Light
{Includeefn} – boolean | optional – if true will include European Fulfillment Network (EFN)
{Includepaneu} – boolean | optional – if true will include PAN – European FBA
{Includepaneulight} – boolean | optional – if true will include PAN – European FBA Small and Light
(optional params)
{efnmarketplace} = (string) – valid values (DE, FR, IT, ES, UK) <-- (by default will based on domain)
{efninventoryplace} = (string) – valid values (DE, FR, IT, ES, UK) <-- (by default will based on domain)
{efncee} = (boolean) – flag to enable Use Central Europe program <-- (default true)
NOTE: EFN, PAN-EU and PAN-EU Light will only be included if domain is DE, FR, IT, ES, UK.
{domain} – optional – defaults to www.amazon.com if unspecified. See Supported Amazon Domains for list.
Http Header (optional) AMZPECTY_CALLBACK_URL={Your callback URL}
Example /api/query/estprofit/B089B74PC4?sellingprice=15.00&secretKey=XXXXXXXXXX&myfbacost=4.99&mymfncost=3.99
RESPONSE
Headers
MediaType application/json
JSON Data
JSON
{
    "status": "OK",
    "responsefor": "estprofit",
    "allowed": 4992,
    "dailyAllowed": 4992,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "60f126e20cf24280ed03be54",
    "dateProcessed": null,
    "domain": null
}

Note: During callback, the rid can be used to link the callback data to the original request call.

ESTIMATE PROFIT QUERY CALLBACK

ESTIMATE PROFIT QUERY CALLBACK REQUEST
Headers Example: https://your.server.com/amzpecty_result {Please provide URL in Preferences Page} URL must be SSL enabled. AMZPECTY-API-SECRET-KEY (header name) – secret key header will be included for the call back server to validate the request origin
MediaType application/json
ESTIMATE PROFIT QUERY CALLBACK JSON SAMPLE DATA
Headers
MediaType application/json
JSON Data
JSON
{
  "status": "OK",
  "responsefor": "estprofit",
  "allowed": 4978,
  "dailyAllowed": null,
  "messageId": null,
  "message": null,
  "data": {
    "asin": "B00WV6B7SA",
    "sellingPrice": 21.9,
    "myFBACost": 0,
    "myMFNCost": 0,
    "fba": {
      "estimatedNetProfit": 8.66,
      "estimatedNetMargin": 39.54,
      "referralRate": 15,
      "referralFee": 3.38,
      "fixedClosingFee": 0.99,
      "variableClosingFee": 0,
      "fulfillmentFee": 5.18,
      "estimatedVATRate": 20,
      "estimatedVATAmount": 3.65,
      "storageFee": 0.04,
      "peakSeasonStorage": false,
      "orderHandlingFee": 0,
      "pickAndPackFee": 0,
      "weightHandlingFee": 0
    },
    "fbaStatus": "Completed",
    "mfn": {
      "estimatedNetProfit": 13.88,
      "estimatedNetMargin": 63.38,
      "referralRate": 15,
      "referralFee": 3.38,
      "fixedClosingFee": 0.99,
      "variableClosingFee": 0,
      "estimatedVATRate": 20,
      "estimatedVATAmount": 3.65
    },
    "mfnStatus": "Completed",
    "fbaLight": {
      "estimatedNetProfit": 8.66,
      "estimatedNetMargin": 39.54,
      "referralRate": 15,
      "referralFee": 3.38,
      "fixedClosingFee": 0.99,
      "variableClosingFee": 0,
      "fulfillmentFee": 5.18,
      "estimatedVATRate": 20,
      "estimatedVATAmount": 3.65,
      "storageFee": 0.04,
      "peakSeasonStorage": false,
      "orderHandlingFee": 0,
      "pickAndPackFee": 0,
      "weightHandlingFee": 0
    },
    "fbaLightStatus": "Completed",
    "efn": {
      "inventoryPlaceIn": "FR",
      "marketplace": "FR",
      "ceeEnabled": true,
      "estimatedNetProfit": 6.58,
      "estimatedNetMargin": 30.05,
      "referralRate": 15,
      "referralFee": 3.38,
      "fixedClosingFee": 0.99,
      "variableClosingFee": 0,
      "fulfillmentFee": 7.26,
      "estimatedVATRate": 20,
      "estimatedVATAmount": 3.65,
      "storageFee": 0.04,
      "peakSeasonStorage": false,
      "orderHandlingFee": 0,
      "pickAndPackFee": 0,
      "weightHandlingFee": 0
    },
    "efnStatus": "Completed",
    "panEU": {
      "inventoryPlaceIn": "FR",
      "marketplace": "FR",
      "ceeEnabled": true,
      "estimatedNetProfit": 8.66,
      "estimatedNetMargin": 39.54,
      "referralRate": 15,
      "referralFee": 3.38,
      "fixedClosingFee": 0.99,
      "variableClosingFee": 0,
      "fulfillmentFee": 5.18,
      "estimatedVATRate": 20,
      "estimatedVATAmount": 3.65,
      "storageFee": 0.04,
      "peakSeasonStorage": false,
      "orderHandlingFee": 0,
      "pickAndPackFee": 0,
      "weightHandlingFee": 0
    },
    "panEUStatus": "Completed",
    "panEULight": {
      "inventoryPlaceIn": "FR",
      "marketplace": "FR",
      "ceeEnabled": true,
      "estimatedNetProfit": 8.66,
      "estimatedNetMargin": 39.54,
      "referralRate": 15,
      "referralFee": 3.38,
      "fixedClosingFee": 0.99,
      "variableClosingFee": 0,
      "fulfillmentFee": 5.18,
      "estimatedVATRate": 20,
      "estimatedVATAmount": 3.65,
      "storageFee": 0.04,
      "peakSeasonStorage": false,
      "orderHandlingFee": 0,
      "pickAndPackFee": 0,
      "weightHandlingFee": 0
    },
    "panEULightStatus": "Completed"
  },
  "rid": "6437751e0cf210053fa49cc1",
  "dateProcessed": 1681356063853,
  "domain": "www.amazon.fr",
  "totalCreditsDeducted": 1
}
ESTIMATE PROFIT QUERY CALLBACK RESPONSE JSON ATTRIBUTES
Attribute NameDetails
statusThe status of the request.
responsefor“sellerinfo” value for Seller Info query result.
allowedThe current allowed request count. Resets monthly.
dailyAllowedThe current allowed daily request count. Resets daily.
messageIdThe id of the message (if any).
messageThe actual message (if any). Please refer to Error Messages.
ridThe request id. This can be used in the Get query as a key.
domainThe corresponding Amazon domain for the Seller.
totalCreditsDeductedThis field indicates how many Amzpecty API credits were used to fulfill this request.
dateProcessedThe date the request was processed unix time format.
data.asinThe ASIN of the product.
data.sellingPriceThe seller selling price.
data.myFBACostThe seller specified total FBA fulfillment cost. (Excluding Amazon Fees)
data.myMFNCostThe seller specified total MFN fulfillment cost. (Excluding Amazon Fees)
data.fbaStatusFBA fees data search status. “Completed” or “Unable to get Data.”
data.fba.estimatedNetProfitThe estimated FBA net profit amount.
data.fba.estimatedNetMarginThe estimated FBA net profit percentage.
data.fba.referralFeeThe Amazon FBA Referral Fee amount.
data.fba.referralRateThe Amazon FBA Referral Fee percentage.
data.fba.variableClosingFeeThe Amazon FBA Variable Closing Fee.
data.fba.fulfillmentFeeThe Amazon FBA Fulfillment Fee.
data.fba.estimatedVATRateThe estimated FBA Vat Rat
data.fba.estimatedVATAmountThe estimated FBA Vat Amount
data.fba.serviceAddons. baggingFeeThe Amazon FBA Service Addon Bagging Fee.
data.fba.serviceAddons. inventoryPlacementFeeThe Amazon FBA Service Addon Inventory Placement Fee.
data.fba.serviceAddons. bubbleWrapFeeThe Amazon FBA Service Addon Bubble Wrap Fee.
data.fba.serviceAddons. labelingFeeThe Amazon FBA Service Labeling Fee.
data.fba.serviceAddons. tapingFeeThe Amazon FBA Service Addon Taping Fee.
data.fba.serviceAddons. opaqueBaggingFeeThe Amazon FBA Service Addon Opaque Bagging Fee.
data.fba.orderHandlingFeeDEPRECATED since September 2022. The Amazon FBA Order Handling Fee.
data.fba.peakSeasonStorageThe Amazon FBA Peak Season Storage Fee flag.
data.fba.storageFeeThe Amazon FBA Storage Fee.
data.fba.pickAndPackFeeDEPRECATED since September 2022. The Amazon FBA Pick and Pack Fee.
data.fba.fixedClosingFeeThe Amazon FBA Fixed Closing Fee.
data.fba.weightHandlingFeeDEPRECATED since September 2022. The Amazon FBA Weight Handling Fee.
data.mfnStatusMFN fees data search status. “Completed” or “Unable to get Data.”
data.mfn.estimatedNetProfitThe estimated MFN net profit amount.
data.mfn.estimatedNetMarginThe estimated MFN net profit percentage.
data.mfn.referralFeeThe Amazon MFN Referral Fee amount.
data.mfn.referralRateThe Amazon MFN Referral Fee percentage.
data.mfn.variableClosingFeeThe Amazon MFN Variable Closing Fee.
data.mfn.fixedClosingFeeThe Amazon MFN Fixed Closing Fee.
data.mfn.estimatedVATRateThe estimated MFN Vat Rate
data.mfn.estimatedVATAmounThe estimated FBA Vat Amoun
data.fbaLightStatusFBA Light fees data search status. “Completed” or “Unable to get Data.”
data.fbaLight.estimatedNetProfitThe estimated FBA Light net profit amount.
data.fbalight.estimatedNetMarginThe estimated FBA Light net margin percentage.
data.fbalight.referralRateThe Amazon FBA Light Referral Fee percentage.
data.fbalight.referralFeeThe Amazon FBA Light Referral Fee amount.
data.fbalight.fixedClosingFeeThe Amazon FBA Light Fixed Closing Fee.
data.fbalight.variableClosingFeeThe Amazon FBA Light Variable Closing Fee.
data.fbalight.fulfillmentFeeThe Amazon FBA Light Fulfillment Fee.
data.fbalight.storageFeeThe Amazon FBA Light Storage Fee.
data.fbalight.peakSeasonStorageThe Amazon FBA Light Peak Season Storage Fee flag.
data.fbalight.orderHandlingFeeThe Amazon FBA Light Order Handing Fee.
data.fbalight.pickAndPackFeeThe Amazon FBA Light Pick and Pack Fee.
data.fbalight.weightHandlingFeeThe Amazon FBA Light Weight Handling Fee.
data.fbalight.estimatedVATRateThe estimated FBA Light Vat Rate
data.fbalight.estimatedVATAmountThe estimated FBA Light Vat Amount
data.efnStatusEFN fees data search status. “Completed” or “Unable to get Data.”
data.efn.inventoryPlaceInThe location of inventory in EFN
data.efn.marketplaceThe marketplace the order was placed. Valid values (DE, FR, IT, ES, UK)
data.efn.ceeEnabledThe flag when Central Europe Program is enabled.
data.efn.estimatedNetProfitThe estimated EFN net profit amount.
data.efn.estimatedNetMarginThe estimated EFN net margin percentage.
data.efn.referralRateThe Amazon EFN Referral Fee percentage.
data.efn.referralFeeThe Amazon EFN Referral Fee amount.
data.efn.fixedClosingFeeThe Amazon EFN Fixed Closing Fee.
data.efn.variableClosingFeeThe Amazon EFN Variable Closing Fee.
data.efn.fulfillmentFeeThe Amazon EFN Fulfillment Fee.
data.efn.storageFeeThe Amazon EFN Storage Fee.
data.efn.peakSeasonStorageThe Amazon EFN Peak Season Storage Fee flag.
data.efn.orderHandlingFeeThe Amazon EFN Order Handing Fee.
data.efn.pickAndPackFeeThe Amazon EFN Pick and Pack Fee.
data.efn.weightHandlingFeeThe Amazon EFN Weight Handling Fee.
data.panEUStatusPan-European fees data search status. “Completed” or “Unable to get Data.”
data.panEU.inventoryPlaceInThe location of inventory in Pan EU.
data. panEU.marketplaceThe marketplace the order was placed. Valid values (DE, FR, IT, ES, UK.
data. panEU.ceeEnabledThe flag when Central Europe Program is enabled.
data. panEU.estimatedNetProfitThe estimated Pan EU net profit amount.
data. panEU.estimatedNetMarginThe estimated Pan EU net margin percentage.
data. panEU.referralRateThe Amazon Pan EU Referral Fee percentage.
data. panEU.referralFeeThe Amazon Pan EU Referral Fee amount.
data. panEU.fixedClosingFeeThe Amazon Pan EU Fixed Closing Fee.
data. panEU.variableClosingFeeThe Amazon Pan EU Variable Closing Fee.
data. panEU.fulfillmentFeeThe Amazon Pan EU Fulfillment Fee.
data. panEU.storageFeeThe Amazon Pan EU Storage Fee.
data. panEU.peakSeasonStorageThe Amazon Pan EU Peak Season Storage Fee flag.
data. panEU.orderHandlingFeeThe Amazon Pan EU Order Handing Fee.
data. panEU.pickAndPackFeeThe Amazon Pan EU Pick and Pack Fee.
data. panEU.weightHandlingFeeThe Amazon Pan EU Weight Handling Fee.
data.panEULightStatusPan-European Light fees data search status. “Completed” or “Unable to get
Data.”
data.panEULight.inventoryPlaceInThe location of inventory in Pan EU Light.
data. panEULight.marketplaceThe marketplace the order was placed. Valid values (DE, FR, IT, ES, UK)
data. panEULight.ceeEnabledThe flag when Central Europe Program is enabled.
data. panEULight.estimatedNetProfitThe estimated Pan EU Light net profit amount.
data. panEULight.estimatedNetMarginThe estimated Pan EU Light net margin percentage.
data. panEULight.referralRateThe Amazon Pan EU Light Referral Fee percentage.
data. panEULight.referralFeeThe Amazon Pan EU Light Referral Fee amount.
data. panEULight.fixedClosingFeeThe Amazon Pan EU Light Fixed Closing Fee.
data. panEULight.variableClosingFeeThe Amazon Pan EU Light Variable Closing Fee.
data. panEULight.fulfillmentFeeThe Amazon Pan EU Light Fulfillment Fee.
data. panEULight.storageFeeThe Amazon Pan EU Light Storage Fee.
data. panEULight.peakSeasonStorageThe Amazon Pan EU Light Peak Season Storage Fee flag.
data. panEULight.orderHandlingFeeThe Amazon Pan EU Light Order Handing Fee.
data. panEULight.pickAndPackFeeThe Amazon Pan EU Light Pick and Pack Fee.
data. panEULight.weightHandlingFeeThe Amazon Pan EU Light Weight Handling Fee.

Note: Some fields maybe have been consolidated or removed in the latest Amazon Revenue Calculator version, but they exist for program compatibility and maybe removed in the future version of the API.

GET ESTIMATED PROFIT RESULT BY REQUEST ID

The request to get the latest Estimated Profit result by Request Id (rid).

CREDIT DEDUCTION

0 (zero) credit deduction for the Get call.

REQUEST
URI /api/query/getestprofit/rid/{rid}?secretKey={secretKey} {rid} – request id from the /api/query/estprofit/ response
Example /api/query/getestprofit/rid/60f12c1a0cf24280ed03be5e?secretKey=XXXXXXXXXX/json
RESPONSE

See Estimate Profit Query Callback JSON Sample Data

Was this article helpful to you? Yes No
How can we help?