Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
Each Amazon MWS API section has its own client library that contains code for doing many common tasks when working with Amazon MWS. By using an Amazon MWS client library, you save time and you know the request you send is correctly formatted. For example, the Amazon MWS client libraries perform the following tasks for you:
You can create your own client library for use with Amazon MWS. Your code should construct and sign a request in the format expected by Amazon MWS, and then you parse the resulting XML response.
You access Amazon MWS by following these steps:
Amazon MWS endpoints vary by region for the marketplace you are trying to access. Consult Amazon MWS endpoints and MarketplaceId values for the correct endpoint to use for your intended marketplace.
Every Amazon MWS API has limits to how often it can be invoked over certain time periods. If you exceed these limits, your call will fail and you will have to wait for your next call. This waiting period will be based on the refresh rate for the API. For more information, see Throttling: Limits to how often you can submit requests.
For each individual API, see the Throttling section on the API reference page for specific throttling limits.
Amazon MWS supports query requests for calling web service actions. Query requests are simple HTTP requests, using the GET or POST method in the HTTP request-line. The HTTP request-line consists of the HTTP method, the URL, and the protocol version. The URL contains the path and query parameters. The HTTP Body contains the HTTP body request parameters. Amazon MWS requires the use of HTTPS in order to prevent third-party eavesdropping on your communication with Amazon.
Each of the HTTP header lines must be terminated with a carriage return and a line feed. Query requests must contain an Action parameter to indicate the action to be performed. The response is an XML document.
Amazon MWS requires that the size of the HTTP request-line must be less than 8190 bytes and the size of the HTTP request body be less than 2048 MB.If you are sending an HTTP request-line that exceeds the limit, then you must reduce your HTTP query parameters and use the HTTP request body parameters.
The following is an example of a complete request URL that you could submit. The actual request should not contain white space or line breaks.