Managing List Items

The ListSearch and ListLookup operations return information about Amazon lists. You can use this information to display the lists in your application or provide a way for others to purchase items from a list.

List Types

There are four types of lists available through ECS:

Listmania

Customers can create random groups of items, called Listmania lists. Listmania lists can be as specific ("Dorm Room Essentials for Every Freshman") or as general ("The Best Novels of 2000") as customers choose.

WishList

Wish lists contain items for birthdays or any other special day. They ensure that gifts go to the right place and that the recipient doesn't receive more than he or she wants.

WeddingRegistry

Wedding registires contain items of interest to a wedding couple.

BabyRegistry

Gift givers can find any baby registry that has been created online, as well as any registry that has been created in a Babies "R" Us or Toys "R" Us store and been made available online.

A customer can set list access restrictions to public, shared, or private. Public lists are accessible by everyone, private lists are not accessible, and shared lists, on the retail web site, are accessible only to people whom the customer identifies. ECS functionality, however, is different. Shared lists, like private lists, are never accessible.

Finding List IDs

Use list IDs to reference a list. There are two ways to find list IDs: using the ListSearch operation and finding the ID using an Amazon web site. See ListSearch Operation for more information on the ListSearch operation. The following tables illustrate where to find list IDs in the URL for an Amazon site.

URLs for WishList IDs

URLs for Listmania List IDs

URLs for WeddingRegistry and BabyRegistry List IDs

Adding List Items

Currently, it is not possible to add items to a list using ECS. Use an Amazon web site to add items to a list:

• www.amazon.com

• www.amazon.co.uk

• www.amazon.de

• www.amazon.co.jp

• www.amazon.fr

• www.amazon.ca

Purchasing List Items

When you purchase an item from a wish list or registry on an Amazon site, the list updates to show that an item was purchased. Your application can also update a list when a customer purchases an item using the information returned by the ListSearch and ListLookup operations. There are two ways for a customer to purchase an item from a list:

• Using a remote cart
• Using the detail page URL

The ListItems response group returns a ListItemId element for each item in a wish list or registry. Use the value of this element along with the item's ASIN to add a list item to a remote shopping cart.

http://webservices.amazon.com/onca/xml?
  AWSAccessKeyId=[Your Access Key ID Here]&
  Service=AWSECommerceService&
  Operation=CartCreate&
  Item.1.Quantity=1&
  Item.1.ASIN=B00003CXCT&
  Item.1.ListItemId=I1JRCAX9I2BC5W

Some response groups, such as Small, return the DetailPageURL element. A customer that goes to the URL has the option to purchase the item, and the wish list or registry updates accordingly.