Migration Guide

If you are an existing Amazon Web Services (AWS) 2.0 or 3.0 developer, you can use this guide to understand how to migrate your AWS applications to Amazon E-Commerce Service (ECS) 4.0. This guide will provide information about migrating requests and obtaining the desired information in your responses.

Before you migrate to ECS 4.0, here are a few things to consider:

ECS 4.0 is not backwards compatible with versions 2.0 and 3.0. The Amazon Web Services team chose to create an all new API for ECS 4.0 that is more usable and consistent. Functionally, ECS 4.0 is essentially the same as AWS 2.0 and 3.0; you will be able to retrieve all the same information. However, you'll access the information through a different set of request types or "operations."
ECS 4.0 was designed in a way that will allow Amazon to add more features over time. Limitations in versions 2.0 and 3.0 do not permit Amazon to expand the APIs in a flexible manner. Features in 4.0, such as Response Groups and Service Versioning, make the new API much more extensible.
Migration to ECS 4.0 is suggested, but not required. Amazon does not plan to deprecate AWS 3.0 for the foreseeable future. If you are using AWS 2.0, we recommend that you at least upgrade to AWS 3.0. The differences between 2.0 and 3.0 are minimal. You can upgrade your REST requests by replacing "2" in your requests with "3". For SOAP, you can migrate by rebuilding your application using the AWS 3.0 WSDL, which located at http://soap.amazon.com/schemas3/AmazonWebServices.wsdl for the US. The 3.0 WSDLs for UK/DE and JP are located at http://soap-eu.amazon.com/schemas3/AmazonWebServices.wsdl and http://soap.amazon.co.jp/schemas3/AmazonWebServices.wsdl, respectively.

To try out the sample requests in this guide, you will need to register for an Amazon Web Services Subscription ID at http://www.amazon.com/gp/aws/registration/registration-form.html.

This migration guide uses REST requests to demonstrate how to migrate to ECS 4.0. SOAP requests may be migrated to the same ECS operations described below. Additionally, only AWS 3.0 requests are included in this guide. Everything that applies to AWS 3.0 requests applies to AWS 2.0 as well.

Request Types

For each request type that was available in AWS 2.0 and 3.0, we have provided equivalent requests (or operations) in Amazon E-Commerce Service 4.0.

Notes:

We have included the AssociateTag parameter for all the ECS 4.0 requests below. This is not a required parameter; you may omit it if you are not an Associate.
The ECS 4.0 requests for product information below use the Medium response group. Unlike the "lite" response type from 2.0 and 3.0, Medium does not return availability. To get availability information for products sold by Amazon, you must include the Offers, OfferFull, or Large response groups in your request. If you wish to obtain availability information for products sold by other vendors, you must also include MerchantId=All in your requests.

ActorSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ActorSearch=Tom%20Hanks &mode=dvd &type=lite &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ActorSearch=Tom%20Hanks &mode=dvd-de &type=lite &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ActorSearch=Tom%20Hanks &mode=dvd-jp &type=lite &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ActorSearch=Tom%20Hanks &mode=dvd-uk &type=lite &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=DVD &Actor=Tom%20Hanks &ResponseGroup=Medium
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=DVD &Actor=Tom%20Hanks &ResponseGroup=Medium
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=DVD &Actor=Tom%20Hanks &ResponseGroup=Medium
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=DVD &Actor=Tom%20Hanks &ResponseGroup=Medium

ArtistSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ArtistSearch=Rolling%20Stones &mode=music &type=lite &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ArtistSearch=Rolling%20Stones &mode=music &type=lite &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ArtistSearch=Rolling%20Stones &mode=music-jp &type=lite &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ArtistSearch=Rolling%20Stones &mode=music &type=lite &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Music &Artist=Rolling%20Stones &ResponseGroup=Medium
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Music &Artist=Rolling%20Stones &ResponseGroup=Medium
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Music &Artist=Rolling%20Stones &ResponseGroup=Medium
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Music &Artist=Rolling%20Stones &ResponseGroup=Medium

AsinSearch

Use the ItemLookup operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &AsinSearch=0596005423 &type=lite &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &AsinSearch=0596005423 &type=lite &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &AsinSearch=0596005423 &type=lite &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &AsinSearch=0596005423 &type=lite &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemLookup &ItemId=0596005423 &ResponseGroup=Medium
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemLookup &ItemId=0596005423 &ResponseGroup=Medium
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemLookup &ItemId=0596005423 &ResponseGroup=Medium
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemLookup &ItemId=0596005423 &ResponseGroup=Medium

AuthorSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &AuthorSearch=Shel%20Silverstein &mode=books &type=lite &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &AuthorSearch=Shel%20Silverstein &mode=books &type=lite &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &AuthorSearch=Shel%20Silverstein &mode=books &type=lite &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &AuthorSearch=Shel%20Silverstein &mode=books &type=lite &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Books &Author=Shel%20Silverstein &ResponseGroup=Medium
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Books &Author=Shel%20Silverstein &ResponseGroup=Medium
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Books &Author=Shel%20Silverstein &ResponseGroup=Medium
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Books &Author=Shel%20Silverstein &ResponseGroup=Medium

BlendedSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 2.0 and 3.0 returned more product groups than are available for ECS 4.0 responses. ECS 4.0 returns items from up to 12 product groups for the US.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &BlendedSearch=digital &type=lite &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &BlendedSearch=digital &type=lite &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &BlendedSearch=digital &type=lite &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &BlendedSearch=digital &type=lite &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Blended &Keywords=digital &ResponseGroup=Medium
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Blended &Keywords=digital &ResponseGroup=Medium
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Blended &Keywords=digital &ResponseGroup=Medium
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Blended &Keywords=digital &ResponseGroup=Medium

BrowseNodeSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &BrowseNodeSearch=289814 &mode=kitchen &type=lite &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &BrowseNodeSearch=3429941 &mode=kitchen-de &type=lite &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &BrowseNodeSearch=3895781 &mode=kitchen-jp &type=lite &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &BrowseNodeSearch=10707831 &mode=kitchen-uk &type=lite &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Kitchen &BrowseNode=289814 &ResponseGroup=Medium
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Kitchen &BrowseNode=3429941 &ResponseGroup=Medium
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Kitchen &BrowseNode=3895781 &ResponseGroup=Medium
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Kitchen &BrowseNode=10707831 &ResponseGroup=Medium

DirectorSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &DirectorSearch=Stephen &mode=dvd &type=lite &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &DirectorSearch=Stephen &mode=dvd-de &type=lite &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &DirectorSearch=Stephen &mode=dvd-jp &type=lite &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &DirectorSearch=Stephen &mode=dvd-uk &type=lite &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=DVD &Director=Stephen &ResponseGroup=Medium
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=DVD &Director=Stephen &ResponseGroup=Medium
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=DVD &Director=Stephen &ResponseGroup=Medium
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=DVD &Director=Stephen &ResponseGroup=Medium

ExchangeSearch

Use the SellerListingLookup operation in Amazon E-Commerce Service.

If the requests below do not return product information, it is because the product associated with the Exchange ID in the requests is no longer available on Amazon. You can find a new Exchange ID on Amazon by searching for products from this page: http://s1.amazon.com/exec/varzea/subst/search/fixed-search.html. On the search results page, click through one of the Marketplace results to a product page and copy the Exchange ID from the product page URL. You may access the equivalent page for UK and Germany (just change the domain). This search page is not available for Japan.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ExchangeSearch=Y01Y5724325Y5991762 &type=lite &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ExchangeSearch=Y06Y1097063Y3987736 &type=lite &f=xml &locale=de
JP	N/A
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ExchangeSearch=Y02Y5428122Y1147650 &type=lite &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=SellerListingLookup &IdType=Exchange &Id=Y01Y5724325Y5991762
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=SellerListingLookup &IdType=Exchange &Id=Y06Y1097063Y3987736
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=SellerListingLookup &IdType=Exchange &Id=Y01Y4720792Y1657030
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=SellerListingLookup &IdType=Exchange &Id=Y02Y5428122Y1147650

KeywordSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &KeywordSearch=zoom &mode=photo &type=lite &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &KeywordSearch=zoom &mode=photo-de &type=lite &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &KeywordSearch=zoom &mode=photo-jp &type=lite &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &KeywordSearch=zoom &mode=photo-uk &type=lite &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Photo &Keywords=zoom &ResponseGroup=Medium
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Photo &Keywords=zoom &ResponseGroup=Medium
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Electronics &Keywords=zoom &ResponseGroup=Medium
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Electronics &Keywords=zoom &ResponseGroup=Medium

ListManiaSearch

Use the ListLookup operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ListManiaSearch=2AZKKQ1OSDCEI &type=lite &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ListManiaSearch=QP0PXSFUUTON &type=lite &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ListManiaSearch=4591YGFA86K5 &type=lite &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ListManiaSearch=24T87OWV0V1YT &type=lite &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ListLookup &ListType=Listmania &ListId=2AZKKQ1OSDCEI &ResponseGroup=ListFull,Medium
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ListLookup &ListType=Listmania &ListId= QP0PXSFUUTON &ResponseGroup=ListFull,Medium
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ListLookup &ListType=Listmania &ListId= 4591YGFA86K5 &ResponseGroup=ListFull,Medium
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ListLookup &ListType=Listmania &ListId=24T87OWV0V1YT &ResponseGroup=ListFull,Medium

ManufacturerSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ManufacturerSearch=Dewalt &mode=tools &type=lite &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ManufacturerSearch=Dewalt &mode=tools-de &type=lite &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ManufacturerSearch=Sony &mode=electronics-jp &type=lite &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ManufacturerSearch=Dewalt &mode=tools-uk &type=lite &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &Operation=ItemSearch &SearchIndex=Tools &Manufacturer=Dewalt &ResponseGroup=Medium
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &Operation=ItemSearch &SearchIndex=Tools &Manufacturer=Dewalt &ResponseGroup=Medium
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Electronics &Manufacturer=Sony &ResponseGroup=Medium
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=DVD &Actor=Tom%20Hanks &ResponseGroup=Medium

MarketplaceSearch

Use the SellerListingSearch operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

These AWS 3.0 requests are similar to ECS 4.0's SellerListingSearch with the Keywords parameter.

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &MarketplaceSearch=keyword &f=xml &type=heavy &keyword=bagpipes &keyword-search=titledesc
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &MarketplaceSearch=keyword &f=xml &type=heavy &keyword=bagpipes &keyword-search=titledesc &locale=de
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &MarketplaceSearch=keyword &f=xml &type=heavy &keyword=bagpipes &keyword-search=titledesc &locale=uk

Locale

Request

http://xml.amazon.com/onca/xml3?dev-t=[Your
Dev Token or Subscription ID Here] &t=[Your
Associate Tag Here] &MarketplaceSearch=keyword &f=xml
&type=heavy &keyword=bagpipes
&keyword-search=titledesc

http://xml-eu.amazon.com/onca/xml3?dev-t=[Your
Dev Token or Subscription ID Here] &t=[Your
Associate Tag Here] &MarketplaceSearch=keyword &f=xml
&type=heavy &keyword=bagpipes &keyword-search=titledesc
&locale=de

http://xml-eu.amazon.com/onca/xml3?dev-t=[Your
Dev Token or Subscription ID Here] &t=[Your
Associate Tag Here] &MarketplaceSearch=keyword &f=xml
&type=heavy &keyword=bagpipes &keyword-search=titledesc
&locale=uk

These AWS 3.0 requests are similar to ECS 4.0's SellerListingSearch with the Title parameter.

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &MarketplaceSearch=keyword &f=xml &type=heavy &keyword=how%20to%20play &keyword-search=title
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &MarketplaceSearch=keyword &f=xml &type=heavy &keyword=how%20to%20play &keyword-search=title &locale=de
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &MarketplaceSearch=keyword &f=xml &type=heavy &keyword=how%20to%20play &keyword-search=title &locale=uk

Locale

Request

http://xml.amazon.com/onca/xml3?dev-t=[Your
Dev Token or Subscription ID Here] &t=[Your
Associate Tag Here] &MarketplaceSearch=keyword &f=xml
&type=heavy &keyword=how%20to%20play
&keyword-search=title

http://xml-eu.amazon.com/onca/xml3?dev-t=[Your
Dev Token or Subscription ID Here] &t=[Your
Associate Tag Here] &MarketplaceSearch=keyword &f=xml
&type=heavy &keyword=how%20to%20play &keyword-search=title
&locale=de

http://xml-eu.amazon.com/onca/xml3?dev-t=[Your
Dev Token or Subscription ID Here] &t=[Your
Associate Tag Here] &MarketplaceSearch=keyword &f=xml
&type=heavy &keyword=how%20to%20play &keyword-search=title
&locale=uk

ECS 4.0 request(s):

SellerListingSearch requests with the Keywords parameter.

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=SellerListingSearch &Keywords=bagpipes
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &Operation=SellerListingSearch &Keywords=bagpipes
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &Operation=SellerListingSearch &Keywords=bagpipes

Locale

Request

http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
&SubscriptionId=[Your Subscription ID Here]
&AssociateTag=[Your Associate Tag Here]
&Operation=SellerListingSearch
&Keywords=bagpipes

http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
&SubscriptionId=[Your Subscription ID Here]
&Operation=SellerListingSearch
&Keywords=bagpipes

http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
&SubscriptionId=[Your Subscription ID Here]
&Operation=SellerListingSearch
&Keywords=bagpipes

SellerListingSearch requests with the Title parameter.

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=SellerListingSearch &Title=how%20to%20play
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=%5bASSOCIATE_TAG%5d &Operation=SellerListingSearch &Title=how%20to%20play
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=%5bASSOCIATE_TAG%5d &Operation=SellerListingSearch &Title=how%20to%20play

Locale

Request

http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
&SubscriptionId=[Your Subscription ID Here]
&AssociateTag=[Your Associate Tag Here]
&Operation=SellerListingSearch
&Title=how%20to%20play

http://webservices.amazon.de/onca/xml?Service=AWSECommerceService
&SubscriptionId=[Your Subscription ID Here]
&AssociateTag=%5bASSOCIATE_TAG%5d &Operation=SellerListingSearch
&Title=how%20to%20play

http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService
&SubscriptionId=[Your Subscription ID Here]
&AssociateTag=%5bASSOCIATE_TAG%5d &Operation=SellerListingSearch
&Title=how%20to%20play

PowerSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &PowerSearch=pubdate:2003%20subject:dog &mode=books &type=lite &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &PowerSearch=pubdate:2003%20subject:history &mode=books-de &type=lite &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &PowerSearch=title:luck &mode=books-de &type=lite &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &PowerSearch=pubdate:2003%20subject:dog &mode=books-uk &type=lite &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Books &Power=pubdate:2003%20subject:dog &ResponseGroup=Medium
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Books &Power=pubdate:2003%20subject:history &ResponseGroup=Medium
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Books &Power=title:luck &ResponseGroup=Medium
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Books &Power=pubdate:2003%20subject:dog &ResponseGroup=Medium

SellerSearch

Use the SellerLookup and SellerListingSearch operations in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &SellerSearch=ASYDZOX0HKBSE &type=lite &f=xml

ECS 4.0 request(s):

Use SellerLookup to get seller profile information, including feedback.

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=SellerLookup &SellerId=ASYDZOX0HKBSE

Use SellerListingSearch to get seller product information.

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=SellerListingSearch &SellerId=ASYDZOX0HKBSE

Locale

Request

http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
&SubscriptionId=[Your Subscription ID Here]
&AssociateTag=[Your Associate Tag Here]
&Operation=SellerListingSearch
&SellerId=ASYDZOX0HKBSE

One step further: Using the multi-operation functionality in ECS 4.0, you can make both of the above ECS requests in one call to Amazon.

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=SellerLookup,SellerListingSearch &SellerLookup.1.SellerId=ASYDZOX0HKBSE &SellerListingSearch.1.SellerId=ASYDZOX0HKBSE

Locale

Request

http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
&SubscriptionId=[Your Subscription ID Here]
&AssociateTag=[Your Associate Tag Here]
&Operation=SellerLookup,SellerListingSearch
&SellerLookup.1.SellerId=ASYDZOX0HKBSE
&SellerListingSearch.1.SellerId=ASYDZOX0HKBSE

ShoppingCart (Add)

Use the CartCreate and CartAdd operations in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=add &Asin.0894802046=1 &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=add &Asin. B0000C6DWS =1 &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=add &Asin. B0001X9BMY=1 &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=add &Asin. B00004RJLB =1 &f=xml &locale=uk

ECS 4.0 request(s):

Use the CartCreate operation to create the cart and add the initial contents.

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartCreate &Item.1.ASIN=B000067DNF &Item.1.Quantity=1
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &Operation=CartCreate &Item.1.ASIN=B0000C6DWS &Item.1.Quantity=1
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &Operation=CartCreate &Item.1.ASIN=B0001X9BMY &Item.1.Quantity=1
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &Operation=CartCreate &Item.1.ASIN=B00004RJLB &Item.1.Quantity=1

Once the cart is created, use the CartAdd operation to add more items to the cart.

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartAdd &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &Item.1.ASIN=0894802046 &Item.1.Quantity=1
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartAdd &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &Item.1.ASIN=B0002UE1MG &Item.1.Quantity=1
JP	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartAdd &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &Item.1.ASIN=4591081451 &Item.1.Quantity=1
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartAdd &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &Item.1.ASIN=B0001ZXA7Y &Item.1.Quantity=1

ShoppingCart (clear)

Use the CartClear operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=clear &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=clear &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=clear &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=clear &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartClear &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here]
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartClear &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here]
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartClear &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here]
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartClear &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here]

ShoppingCart (Get)

Use the CartGet operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=get &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=get &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=get &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=get &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartGet &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here]
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartGet &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here]
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartGet &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here]
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartGet &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here]

ShoppingCart (Modify)

Use the CartModify operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=modify &Item.[Cart Item ID Here]=3 &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=modify &Item.[Cart Item ID Here]=3 &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=modify &Item.[Cart Item ID Here]=3 &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=modify &Item.[Cart Item ID Here]=3 &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartModify &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &Item.1.CartItemId=[Cart Item ID Here] &Item.1.Quantity=3
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartModify &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &Item.1.CartItemId=[Cart Item ID Here] &Item.1.Quantity=3
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartModify &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &Item.1.CartItemId=[Cart Item ID Here] &Item.1.Quantity=3
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartModify &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &Item.1.CartItemId=[Cart Item ID Here] &Item.1.Quantity=3

ShoppingCart (Remove)

Use the CartModify operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=remove &Item.[Cart Item ID Here] &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=remove &Item.[Cart Item ID Here] &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=remove &Item.[Cart Item ID Here] &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &ShoppingCart=remove &Item.[Cart Item ID Here] &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartModify &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &Item.1.CartItemId=[Cart Item ID Here] &Item.1.Quantity=0
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartModify &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &Item.1.CartItemId=[Cart Item ID Here] &Item.1.Quantity=0
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartModify &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &Item.1.CartItemId=[Cart Item ID Here] &Item.1.Quantity=0
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=CartModify &CartId=[Your Cart ID Here] &HMAC=[Your HMAC Here] &Item.1.CartItemId=[Cart Item ID Here] &Item.1.Quantity=0

SimilaritySearch

Use the SimilarityLookup operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &SimilaritySearch=B00005N7P3 &type=lite &f=xml
DE	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &SimilaritySearch=B0002TJNXE &type=lite &f=xml &locale=de
JP	http://xml.amazon.co.jp/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &SimilaritySearch=4569636624 &type=lite &f=xml &locale=jp
UK	http://xml-eu.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &SimilaritySearch=B00009PB6N &type=lite &f=xml &locale=uk

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=SimilarityLookup &ItemId=B00005N7P3 &ResponseGroup=Medium
DE	http://webservices.amazon.de/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=SimilarityLookup &ItemId= B0002TJNXE &ResponseGroup=Medium
JP	http://webservices.amazon.co.jp/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &Operation=SimilarityLookup &ItemId=4569636624 &ResponseGroup=Medium
UK	http://webservices.amazon.co.uk/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=SimilarityLookup &ItemId= B00009PB6N &ResponseGroup=Medium

TextStreamSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &TextStreamSearch=fast%20food%20is%20good%20and%20bad &mode=books &type=lite &f=xml

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemSearch &SearchIndex=Books &TextStream=fast%20food%20is%20good%20and%20bad &ResponseGroup=Medium

Locale

Request

http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
&SubscriptionId=[Your Subscription ID Here]
&AssociateTag=[Your Associate Tag Here]
&Operation=ItemSearch &SearchIndex=Books
&TextStream=fast%20food%20is%20good%20and%20bad
&ResponseGroup=Medium

UpcSearch

Use the ItemLookup operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &UpcSearch=097360650549 &mode=dvd &type=lite &f=xml

ECS 4.0 request(s):

Locale	Request
US	http://webservices.amazon.com/onca/xml?Service=AWSECommerceService &SubscriptionId=[Your Subscription ID Here] &AssociateTag=[Your Associate Tag Here] &Operation=ItemLookup &IdType=UPC &ItemId=097360650549 &SearchIndex=DVD &ResponseGroup=Medium

Locale

Request

http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
&SubscriptionId=[Your Subscription ID Here]
&AssociateTag=[Your Associate Tag Here]
&Operation=ItemLookup &IdType=UPC &ItemId=097360650549
&SearchIndex=DVD &ResponseGroup=Medium

WishlistSearch

Use the ListLookup operation in Amazon E-Commerce Service.

AWS 3.0 request(s):

Locale	Request
US	http://xml.amazon.com/onca/xml3?dev-t=[Your Dev Token or Subscription ID Here] &t=[Your Associate Tag Here] &WishlistSearch=2AT7V3BAJ69DX &type=lite &f=xml

ECS 4.0 request(s):

Locale

Request

http://webservices.amazon.com/onca/xml?Service=AWSECommerceService
&SubscriptionId=[Your Subscription ID Here]
&AssociateTag=[Your Associate Tag Here]
&Operation=ListLookup &ListType=WishList &ListId=2AT7V3BAJ69DX
&ResponseGroup=ListFull,Medium

Response Types

In AWS 2.0 and 3.0, AWS developers were able to request a "lite" response or a "heavy" response for every request type. This basically gave you access to "less" or "more" data. Many developers saw these options as limiting and inflexible. Amazon E-Commerce Service 4.0 introduces the concept of Response Groups, which are logical groups of XML elements that can optionally be selected in operation requests.

For example, if you are using the ItemSearch operation to search for products, you can use the SalesRank response group to retrieve only the SalesRank element for all the products in the response. Alternatively, you could ask for the Small response group, which returns several elements, including the product's title, product group, manufacturer, and Amazon detail page URL.

Response groups may contain a single element, multiple related elements, or multiple elements and one or more other response groups. Response groups that contain other response groups are called parent response groups.

For products, the "lite" response type in AWS 2.0 and 3.0 roughly falls in between the Small and Medium response groups in Amazon E-Commerce Service 4.0; Small contains fewer elements than "lite", while Medium contains more elements than "lite". The "heavy" response type from AWS 2.0 and 3.0 maps roughly to Large in Amazon E-Commerce Service 4.0; Large actually contains more information than "heavy". Large is the biggest available response group for product information, and since Amazon E-Commerce Service 4.0 returns more information than was ever available in AWS 2.0 or 3.0, this is a big response group!

Whereas the response types in AWS 2.0 and 3.0 were inflexible, the response groups available in Amazon E-Commerce Service 4.0 give developers much more flexibility to customize responses and get only what they want. Additionally, response groups were designed in a way that allows the AWS team to add response groups as necessary. If we find that the current set of groups does not allow developers to get just what they want, we have the ability to add new groups over time. If you have a response group idea, please feel free to post it on the AWS discussion board at http://forums.prospero.com/am-assocdevxml.