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]