Amazon Marketplace Web Service (Amazon MWS) is an integrated Web service API that helps Amazon sellers to programmatically exchange data on listings, orders, payments, reports, and more.

1. AMAZON
MWS API
1

2. WHAT IS MWS API?
• MWS STAND FOR MARKETPLACE WEB SERVICE
• AMAZON MARKETPLACE WEB SERVICE (AMAZON MWS) IS AN
INTEGRATED WEB SERVICE API THAT HELPS AMAZON SELLERS TO
PROGRAMMATICALLY EXCHANGE DATA ON LISTINGS, ORDERS,
PAYMENTS, REPORTS, AND MORE.
• XML DATA INTEGRATION WITH AMAZON ENABLES HIGHER LEVELS OF
SELLING AUTOMATION, WHICH HELPS SELLERS GROW THEIR BUSINESS.
BY USING AMAZON MWS, SELLERS CAN INCREASE SELLING EFFICIENCY,
REDUCE LABOR REQUIREMENTS, AND IMPROVE RESPONSE TIME TO
CUSTOMERS
• THERE ARE NO FEES ASSOCIATED WITH AMAZON MWS, BUT TO USE
THE AMAZON MWS API YOU MUST HAVE AN AMAZON MWS-ELIGIBLE
SELLER ACCOUNT AND YOU MUST REGISTER TO USE AMAZON MWS. 2

3. BASIC REQUIREMENT FOR MWS API
1) MWS END POINTS
2) MARKET PLACE ID
3) SELLER ID
4) AUTH TOKEN
5) SECRET KEY
6) ACCESS KEY ID 3

4. 1) MWS ENDPOINT
• FOR USE OF MWS API YOU NEED TO SPECIFY YOUR SELLER
ACCOUNT ENDPOINT
• END POINT IS KIND OF REGION OF YOUR SELLER ACCOUNT
• FOR EXAMPLE IF YOUR ACCOUNT BELONGS TO NORTH AMERICA
(NA) THEN YOUR ENDPOINT IS
HTTPS://MWS.AMAZONSERVICES.COM YOU CAN FIND LIST OF
REGIONS HERE
HTTP://DOCS.DEVELOPER.AMAZONSERVICES.COM/EN_IN/DEV_G
UIDE/DG_ENDPOINTS.HTML
2) MARKETPLACE
• EVERY SELLER ACCOUNT HAS ITS MARKETPLACE ID WHICH
YOU CAN DEFINE BASED ON REGION OF SELLER CENTRAL
ACCOUNT YOU USE
• EVERY REGIONS HAS ITS DIFFERENT MARKETPLACE ID SO ITS
NECESSARY TO DEFINE MARKETPLACE ID WHEN YOU USE MWS
API
• YOU CAN FIND LIST OF MARKET PLACE ID HERE
4

5. 3) SELLERID
• EVERY SELLER HAS HIS UNIQUE SELLERID THIS IS GENERATE WHEN SELLER
HAS REGISTER FOR MWS API USE. THIS PARAMETER IS COMPULSORY
WHEN YOU USE MWS API
4) AUTH TOKEN
• EVERY SELLER HAS HIS UNIQUE AUTH TOKEN THIS IS GENERATE WHEN SELLER HAS
REGISTER FOR MWS API USE. THIS PARAMETER IS COMPULSORY WHEN YOU USE
MWS API
5) SECRETKEY
• EVERY SELLER HAS HIS UNIQUE SECRETKEY THIS IS GENERATE WHEN SELLER HAS REGISTER FOR MWS
API USE. THIS PARAMETER IS COMPULSORY WHEN YOU USE MWS API
6) AWSACCESSKEYID
• EVERY SELLER HAS HIS UNIQUE AWSACCESSKEYID THIS IS GENERATE WHEN SELLER
HAS REGISTER FOR MWS API USE. THIS PARAMETER IS COMPULSORY WHEN YOU
USE MWS API 5

6. LIST OF MWS API REFERENCE
BELOW ARE THE WIDELY USED API
• FEEDS
• FINANCES
• ORDER
• PRODUCT
• RECOMMENDATION
• REPORTS
• SUBSCRIPTION
6

7. GLIMPS OF API REFERENCES
FEEDS
FEEDS API LETS YOU UPLOAD INVENTORY AND ORDER DATA
TO AMAZON. YOU CAN ALSO USE THE AMAZON MWS FEEDS
API SECTION TO GET INFORMATION ABOUT THE PROCESSING
OF FEEDS.
LIST OF OPERATION PERFORM ON FEEDS API
SUBMITFEED
GETFEEDSUBMISSIONLIST
GETFEEDSUBMISSIONLISTBYNEXTTOKEN
GETFEEDSUBMISSIONCOUNT
CANCELFEEDSUBMISSIONS
GETFEEDSUBMISSIONRESULT
7

8. FINANCES
 THE FINANCES API ENABLES YOU TO OBTAIN FINANCIAL
INFORMATION RELEVANT TO YOUR BUSINESS WITH AMAZON.
YOU CAN OBTAIN FINANCIAL EVENTS FOR A GIVEN ORDER,
FINANCIAL EVENT GROUP, OR DATE RANGE WITHOUT HAVING
TO WAIT UNTIL A STATEMENT PERIOD CLOSES. YOU CAN ALSO
OBTAIN FINANCIAL EVENT GROUPS FOR A GIVEN DATE RANGE.
LIST OF OPERATION PERFORM ON FINANCES API
LISTFINANCIALEVENTGROUPS
LISTFINANCIALEVENTGROUPSBYNEXTTOKEN
LISTFINANCIALEVENTS
LISTFINANCIALEVENTSBYNEXTTOKEN
GETSERVICESTATUS
8

9. ORDERS
WITH THE ORDERS YOU CAN BUILD SIMPLE APPLICATIONS
THAT RETRIEVE ONLY THE ORDER INFORMATION THAT YOU
NEED. THIS ENABLES YOU TO DEVELOP FAST, FLEXIBLE,
CUSTOM APPLICATIONS IN AREAS LIKE ORDER
SYNCHRONIZATION, ORDER RESEARCH, AND DEMAND-BASED
DECISION SUPPORT TOOLS.
LIST OF OPERATION PERFORM ON ORDERS API
LISTORDERS
LISTORDERSBYNEXTTOKEN
GETORDER
LISTORDERITEMS
LISTORDERITEMSBYNEXTTOKEN
9

10. PRODUCT API
 THE PRODUCTS API HELPS YOU GET INFORMATION TO MATCH YOUR PRODUCTS
TO EXISTING PRODUCT LISTINGS ON AMAZON MARKETPLACE WEBSITES AND TO
MAKE SOURCING AND PRICING DECISIONS FOR LISTING THOSE PRODUCTS ON
AMAZON MARKETPLACE WEBSITES. THE AMAZON MWS PRODUCTS API RETURNS
PRODUCT ATTRIBUTES, CURRENT MARKETPLACE PRICING INFORMATION, AND A
VARIETY OF OTHER PRODUCT AND LISTING INFORMATION.
 LIST OF OPERATION PERFORM ON ORDERS API
 LISTMATCHINGPRODUCTS
 GETMATCHINGPRODUCT
 GETMATCHINGPRODUCTFORID
 GETCOMPETITIVEPRICINGFORSKU
 GETLOWESTOFFERLISTINGSFORSKU
 GETLOWESTOFFERLISTINGSFORASIN
 GETLOWESTPRICEDOFFERSFORSKU
 GETLOWESTPRICEDOFFERSFORASIN
 GETMYFEESESTIMATE
 GETMYPRICEFORSKU
 GETMYPRICEFORASIN
 GETPRODUCTCATEGORIESFORSKU
 GETPRODUCTCATEGORIESFORASIN 10

11. RECOMMENDATIONS API
 THE RECOMMENDATIONS API SECTION OF AMAZON MWS ENABLES YOU TO
PROGRAMMATICALLY RETRIEVE AMAZON SELLING COACH
RECOMMENDATIONS BY RECOMMENDATION CATEGORY. A
RECOMMENDATION IS AN ACTIONABLE, TIMELY, AND PERSONALIZED
OPPORTUNITY TO INCREASE YOUR SALES AND PERFORMANCE.
RECOMMENDATIONS ARE PROVIDED FOR THE FOLLOWING CATEGORIES:
• INVENTORY: RECOMMENDATIONS FOR RESTOCKING LOW OR OUT-OF-STOCK ITEMS IN
YOUR INVENTORY.
• SELECTION: RECOMMENDATIONS FOR NEW PRODUCT OPPORTUNITIES TO LIST ON
AMAZON.
• PRICING: RECOMMENDATIONS TO REVIEW PRICING ON ITEMS IN YOUR INVENTORY
WHERE YOUR OFFER IS NOT THE LOWEST PRICE.
• FULFILLMENT: RECOMMENDATIONS FOR THE TOP PRODUCTS TO FULFILL THROUGH
FULFILLMENT BY AMAZON (FBA).
• LISTING QUALITY: RECOMMENDATIONS FOR FIXING YOUR CURRENT LISTING DEFECTS.
• GLOBAL SELLING: RECOMMENDATIONS FOR EXPANDING YOUR PRODUCTS TO MORE
REGIONS AND MARKETPLACES.
• ADVERTISING: RECOMMENDATIONS FOR ADVERTISING YOUR PRODUCTS AND FOR USING
THE SPONSORED PRODUCTS PROGRAM.
 LIST OF OPERATION PERFORM ON RECOMMENDATIONS API
 GETLASTUPDATEDTIMEFORRECOMMENDATIONS
 LISTRECOMMENDATIONS
11

12. REPORT
THE REPORTS API LETS YOU REQUEST VARIOUS REPORTS THAT
HELP YOU MANAGE YOUR SELL ON AMAZON BUSINESS.
THERE ARE AROUND 50 TO 60 TYPES OF REPORTS THAT YOU
CAN GENERATE USING MWS API . THESE REPORTS ARE
CATEGORIES INTO FOLLOWING TYPE
• LISTINGS REPORTS
• ORDER REPORTS
• ORDER TRACKING REPORTS
• PENDING ORDER REPORTS
• PERFORMANCE REPORTS
• SETTLEMENT REPORTS
• FULFILLMENT BY AMAZON (FBA) REPORTS
• SALES TAX REPORTS
• BROWSE TREE REPORTS
12

13. REPORT
LIST OF OPERATION PERFORM ON RECOMMENDATIONS API
• REQUESTREPORT
• GETREPORTREQUESTLIST
• GETREPORTREQUESTLISTBYNEXTTOKEN
• GETREPORTREQUESTCOUNT
• PERFORMANCE REPORTS
• CANCELREPORTREQUESTS
• GETREPORTLIST
• GETREPORTLISTBYNEXTTOKEN
• GETREPORTCOUNT
• GETREPORT
• MANAGEREPORTSCHEDULE
• GETREPORTSCHEDULELIST
• GETREPORTSCHEDULECOUNT
13

14. REPORT
WHEN YOU WORKING WITH REPORTS API PLEASE MAKE SURE
YOU ENTER VALID REPORT NAME YOU WANT TO GENERATE
ALSO IF YOU WORKING WITH REPORT PLEASE TAKE A NOT
THAT WHEN YOU REQUEST ANY REPORT TO GENERATE IT WILL
GO INTO MWS QUEUE SO SOMETIME IT WILL TAKE TIME TO
GENERATE YOU CAN’T DIRECTLY FIND RESPONSE OF THE
REPORTS
THERE ARE SOME REPORT THAT YOU CAN NOT GENERATE
DIRECTLY YOU HAVE TO ADD REPORT IN TO SCHEDULE API
ONCE YOU SET SCHEDULE THE REPORT IT WILL
AUTOMATICALLY GENERATE REPORT ACCORDING TO YOUR
SETTING
14

15. SELLER
THE SELLER AP LETS SELLERS RETRIEVE INFORMATION ABOUT
THEIR SELLER ACCOUNT, SUCH AS THE MARKETPLACES THEY
PARTICIPATE IN. ALONG WITH LISTING THE MARKETPLACES
THAT A SELLER CAN SELL IN, THE API ALSO PROVIDES
ADDITIONAL INFORMATION ABOUT THE MARKETPLACE SUCH
AS THE DEFAULT LANGUAGE AND THE DEFAULT CURRENCY.
THE API ALSO PROVIDES SELLER-SPECIFIC INFORMATION SUCH
AS WHETHER THE SELLER HAS SUSPENDED LISTINGS IN THAT
MARKETPLACE
LIST OF OPERATION PERFORM ON SELLER API
• LISTMARKETPLACEPARTICIPATIONS
• LISTMARKETPLACEPARTICIPATIONSBYNEXTTOKEN
15

16. HOW TO INTEGRATE MWS API
SINCE AMAZON PROVIDE ALL LIBRARY FOR THAT YOU DON’T
NEED TO WRITE ANY CODE YOU HAVE TO JUST DOWNLOAD THE
LIBRARY OF API YOU WANT TO INTEGRATE
AMAZON PROVIDE THE LIBRARY FOR PHP,JAVA,C#
ONCE YOU PLACED LIBRARY INTO YOU APPLICATION YOU HAVE
TO JUST CALL LIBRARY FUNCTION FROM YOU CODE
SINCE AMAZON PROVIDE THE RESPONSE DATA INTO XML YOU
NEED TO CONVERT THAT INTO ARRAY OR THE FORMAT YOU
WANT.
LET LOOK AT THE EXAMPLE FOR INTEGRATION 16

17. 17

18. 18

19. 19

20. 20

21. www.drsarma.in 21

22. www.drsarma.in 22

23. ERROR HANDLING IN MWS API
www.drsarma.in 23

24. POINTS TO TAKE CARE
 ONCE THE DATA RETURNS YOU NEED TO CONVERT INTO THE FORMAT YOU
WANT BECAUSE AMAZON RETURN RESPONSE ALWAYS IN XML FORMAT
 THERE ARE LIMIT ON EVERY REQUEST YOU MAKE USING MWS API. EVERY API
HAS DIFFERENT LIMIT FOR EXAMPLE YOU CAN MAKE ONLY 30 REQUEST OF
LIST ORDER API IN 1 MINUTE OTHER WISE MWS WILL THROWS THROTTLE
ERROR.
 OTHER NOTABLE THING IS WHEN YOU WORKING WITH MULTIPLE SELLER OR
YOU DEVELOPING PRODUCT BASE APPLICATION FOR AMAZON SELLERS YOU
HAVE TO CREATE YOU OWN DEVELOPER APPLICATION AFTER CREATING THAT
YOU WILL RECEIVE ACCESSKEYID AND SECRET KEY WHICH YOU CAN USE IN
ALL THE SELLER CENTRAL ACCOUNT WITHIN APPLICATION
24

25. 25
India +91 99133-44050
USA +1 618-300-1610