Prerequisites for MWS connectivity¶
All links in this documentation point to the
domain, but other regional domains are provided by Amazon. For a list of portals for other
regions, please see Related Resources (MWS documentation link).
In order to use python-amazon-mws, you must have an Amazon Professional Seller account, and you must register as a developer. You will then be provided a set of MWS credentials, which include your Seller ID, Access Key, and Secret Key (and, possibly, Auth Token).
These credentials, along with a Marketplace ID, will be needed to make requests to MWS, whether using python-amazon-mws or any other MWS-related service.
Test MWS access using Scratchpad¶
You can test your access to MWS using Amazon MWS Scratchpad (docs):
Open the Scratchpad.
Always verify the URL of the Scratchpad before entering your MWS credentials! The domain should be
mws.amazonservices.comor one of Amazon’s other regional domains (see here for a list of regional portals).
Enter your MWS credentials in the Authentication section.
In API Section, choose “Products”.
In Operation, choose “ListMatchingProducts”.
Under Required API Parameters, enter:
MarketplaceID: A valid MarketplaceID for your desired marketplace (example:
ATVPDKIKX0DERfor the US market). See: Amazon MWS endpoints and MarketplaceId values.
python, to search for products containing “python” somewhere in their description.
If your access works, you should an XML response beginning with
Otherwise, you may see an
ErrorResponse, with an error message indicating the problem.