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 Name | Details |
---|---|
status | The status of the request. |
responsefor | “sellerinfo” value for Seller Info query result. |
allowed | The current allowed request count. Resets monthly. |
dailyAllowed | The current allowed daily request count. Resets daily. |
messageId | The id of the message (if any). |
message | The actual message (if any). Please refer to Error Messages. |
rid | The request id. This can be used in the Get query as a key. |
domain | The corresponding Amazon domain for the Seller. |
totalCreditsDeducted | This field indicates how many Amzpecty API credits were used to fulfill this request. |
dateProcessed | The date the request was processed unix time format. |
data.asin | The ASIN of the product. |
data.sellingPrice | The seller selling price. |
data.myFBACost | The seller specified total FBA fulfillment cost. (Excluding Amazon Fees) |
data.myMFNCost | The seller specified total MFN fulfillment cost. (Excluding Amazon Fees) |
data.fbaStatus | FBA fees data search status. “Completed” or “Unable to get Data.” |
data.fba.estimatedNetProfit | The estimated FBA net profit amount. |
data.fba.estimatedNetMargin | The estimated FBA net profit percentage. |
data.fba.referralFee | The Amazon FBA Referral Fee amount. |
data.fba.referralRate | The Amazon FBA Referral Fee percentage. |
data.fba.variableClosingFee | The Amazon FBA Variable Closing Fee. |
data.fba.fulfillmentFee | The Amazon FBA Fulfillment Fee. |
data.fba.estimatedVATRate | The estimated FBA Vat Rat |
data.fba.estimatedVATAmount | The estimated FBA Vat Amount |
data.fba.serviceAddons. baggingFee | The Amazon FBA Service Addon Bagging Fee. |
data.fba.serviceAddons. inventoryPlacementFee | The Amazon FBA Service Addon Inventory Placement Fee. |
data.fba.serviceAddons. bubbleWrapFee | The Amazon FBA Service Addon Bubble Wrap Fee. |
data.fba.serviceAddons. labelingFee | The Amazon FBA Service Labeling Fee. |
data.fba.serviceAddons. tapingFee | The Amazon FBA Service Addon Taping Fee. |
data.fba.serviceAddons. opaqueBaggingFee | The Amazon FBA Service Addon Opaque Bagging Fee. |
data.fba.orderHandlingFee | DEPRECATED since September 2022. The Amazon FBA Order Handling Fee. |
data.fba.peakSeasonStorage | The Amazon FBA Peak Season Storage Fee flag. |
data.fba.storageFee | The Amazon FBA Storage Fee. |
data.fba.pickAndPackFee | DEPRECATED since September 2022. The Amazon FBA Pick and Pack Fee. |
data.fba.fixedClosingFee | The Amazon FBA Fixed Closing Fee. |
data.fba.weightHandlingFee | DEPRECATED since September 2022. The Amazon FBA Weight Handling Fee. |
data.mfnStatus | MFN fees data search status. “Completed” or “Unable to get Data.” |
data.mfn.estimatedNetProfit | The estimated MFN net profit amount. |
data.mfn.estimatedNetMargin | The estimated MFN net profit percentage. |
data.mfn.referralFee | The Amazon MFN Referral Fee amount. |
data.mfn.referralRate | The Amazon MFN Referral Fee percentage. |
data.mfn.variableClosingFee | The Amazon MFN Variable Closing Fee. |
data.mfn.fixedClosingFee | The Amazon MFN Fixed Closing Fee. |
data.mfn.estimatedVATRate | The estimated MFN Vat Rate |
data.mfn.estimatedVATAmoun | The estimated FBA Vat Amoun |
data.fbaLightStatus | FBA Light fees data search status. “Completed” or “Unable to get Data.” |
data.fbaLight.estimatedNetProfit | The estimated FBA Light net profit amount. |
data.fbalight.estimatedNetMargin | The estimated FBA Light net margin percentage. |
data.fbalight.referralRate | The Amazon FBA Light Referral Fee percentage. |
data.fbalight.referralFee | The Amazon FBA Light Referral Fee amount. |
data.fbalight.fixedClosingFee | The Amazon FBA Light Fixed Closing Fee. |
data.fbalight.variableClosingFee | The Amazon FBA Light Variable Closing Fee. |
data.fbalight.fulfillmentFee | The Amazon FBA Light Fulfillment Fee. |
data.fbalight.storageFee | The Amazon FBA Light Storage Fee. |
data.fbalight.peakSeasonStorage | The Amazon FBA Light Peak Season Storage Fee flag. |
data.fbalight.orderHandlingFee | The Amazon FBA Light Order Handing Fee. |
data.fbalight.pickAndPackFee | The Amazon FBA Light Pick and Pack Fee. |
data.fbalight.weightHandlingFee | The Amazon FBA Light Weight Handling Fee. |
data.fbalight.estimatedVATRate | The estimated FBA Light Vat Rate |
data.fbalight.estimatedVATAmount | The estimated FBA Light Vat Amount |
data.efnStatus | EFN fees data search status. “Completed” or “Unable to get Data.” |
data.efn.inventoryPlaceIn | The location of inventory in EFN |
data.efn.marketplace | The marketplace the order was placed. Valid values (DE, FR, IT, ES, UK) |
data.efn.ceeEnabled | The flag when Central Europe Program is enabled. |
data.efn.estimatedNetProfit | The estimated EFN net profit amount. |
data.efn.estimatedNetMargin | The estimated EFN net margin percentage. |
data.efn.referralRate | The Amazon EFN Referral Fee percentage. |
data.efn.referralFee | The Amazon EFN Referral Fee amount. |
data.efn.fixedClosingFee | The Amazon EFN Fixed Closing Fee. |
data.efn.variableClosingFee | The Amazon EFN Variable Closing Fee. |
data.efn.fulfillmentFee | The Amazon EFN Fulfillment Fee. |
data.efn.storageFee | The Amazon EFN Storage Fee. |
data.efn.peakSeasonStorage | The Amazon EFN Peak Season Storage Fee flag. |
data.efn.orderHandlingFee | The Amazon EFN Order Handing Fee. |
data.efn.pickAndPackFee | The Amazon EFN Pick and Pack Fee. |
data.efn.weightHandlingFee | The Amazon EFN Weight Handling Fee. |
data.panEUStatus | Pan-European fees data search status. “Completed” or “Unable to get Data.” |
data.panEU.inventoryPlaceIn | The location of inventory in Pan EU. |
data. panEU.marketplace | The marketplace the order was placed. Valid values (DE, FR, IT, ES, UK. |
data. panEU.ceeEnabled | The flag when Central Europe Program is enabled. |
data. panEU.estimatedNetProfit | The estimated Pan EU net profit amount. |
data. panEU.estimatedNetMargin | The estimated Pan EU net margin percentage. |
data. panEU.referralRate | The Amazon Pan EU Referral Fee percentage. |
data. panEU.referralFee | The Amazon Pan EU Referral Fee amount. |
data. panEU.fixedClosingFee | The Amazon Pan EU Fixed Closing Fee. |
data. panEU.variableClosingFee | The Amazon Pan EU Variable Closing Fee. |
data. panEU.fulfillmentFee | The Amazon Pan EU Fulfillment Fee. |
data. panEU.storageFee | The Amazon Pan EU Storage Fee. |
data. panEU.peakSeasonStorage | The Amazon Pan EU Peak Season Storage Fee flag. |
data. panEU.orderHandlingFee | The Amazon Pan EU Order Handing Fee. |
data. panEU.pickAndPackFee | The Amazon Pan EU Pick and Pack Fee. |
data. panEU.weightHandlingFee | The Amazon Pan EU Weight Handling Fee. |
data.panEULightStatus | Pan-European Light fees data search status. “Completed” or “Unable to get Data.” |
data.panEULight.inventoryPlaceIn | The location of inventory in Pan EU Light. |
data. panEULight.marketplace | The marketplace the order was placed. Valid values (DE, FR, IT, ES, UK) |
data. panEULight.ceeEnabled | The flag when Central Europe Program is enabled. |
data. panEULight.estimatedNetProfit | The estimated Pan EU Light net profit amount. |
data. panEULight.estimatedNetMargin | The estimated Pan EU Light net margin percentage. |
data. panEULight.referralRate | The Amazon Pan EU Light Referral Fee percentage. |
data. panEULight.referralFee | The Amazon Pan EU Light Referral Fee amount. |
data. panEULight.fixedClosingFee | The Amazon Pan EU Light Fixed Closing Fee. |
data. panEULight.variableClosingFee | The Amazon Pan EU Light Variable Closing Fee. |
data. panEULight.fulfillmentFee | The Amazon Pan EU Light Fulfillment Fee. |
data. panEULight.storageFee | The Amazon Pan EU Light Storage Fee. |
data. panEULight.peakSeasonStorage | The Amazon Pan EU Light Peak Season Storage Fee flag. |
data. panEULight.orderHandlingFee | The Amazon Pan EU Light Order Handing Fee. |
data. panEULight.pickAndPackFee | The Amazon Pan EU Light Pick and Pack Fee. |
data. panEULight.weightHandlingFee | The 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 |