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:

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:

ActorSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

ArtistSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

AsinSearch

Use the ItemLookup operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

AuthorSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

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 requests [Show]

ECS 4.0 requests [Show]

BrowseNodeSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

DirectorSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

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 the other locales.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

KeywordSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

ListManiaSearch

Use the ListLookup operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

ManufacturerSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

MarketplaceSearch

Use the SellerListingSearch operation in Amazon E-Commerce Service.

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

AWS 3.0 requests [Show]

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

AWS 3.0 requests [Show]

SellerListingSearch requests with the Keywords parameter.

ECS 4.0 requests [Show]

SellerListingSearch requests with the Title parameter.

ECS 4.0 requests [Show]

PowerSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

SellerSearch

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

AWS 3.0 requests [Show]

Use SellerLookup to get seller profile information, including feedback.

ECS 4.0 requests [Show]

Use SellerListingSearch to get seller product information.

ECS 4.0 requests [Show]

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.

ECS 4.0 requests [Show]

ShoppingCart (Add)

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

AWS 3.0 requests [Show]

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

ECS 4.0 requests [Show]

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

ECS 4.0 requests [Show]

ShoppingCart (clear)

Use the CartClear operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

ShoppingCart (Get)

Use the CartGet operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

ShoppingCart (Modify)

Use the CartModify operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

ShoppingCart (Remove)

Use the CartModify operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

SimilaritySearch

Use the SimilarityLookup operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

TextStreamSearch

Use the ItemSearch operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

UpcSearch

Use the ItemLookup operation in Amazon E-Commerce Service.

AWS 3.0 requests [Show]

ECS 4.0 requests [Show]

WishlistSearch

Use the ListLookup operation in Amazon E-Commerce Service.

AWS 3.0 request [Show]

ECS 4.0 request [Show]

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.