Finding Items on Lists

• Wedding registry—Items the couple would like for their wedding.

  You can add items to your wedding registry using data returned in the Small response group. For more information, see Adding Items to Lists.

• Baby registry—Items wanted for a baby shower.

  You can add items to your baby registry using data returned in the Small response group. For more information, see Adding Items to Lists.

• Listmania—Items wanted that have a customer-specified theme

• Wishlists—Items wanted for any occasion, such as a birthday or anniversary.

  You can add items to your wishlist using data returned in the Small response group. For more information, see Adding Items to Lists.

To find items on a customer's list

1. Find the customer's list ID by supplying that customer's name or e-mail address in the ListSearch operations.

2. Use the list ID you find in the ListLookup operation to find the items on the customer's lists.

Given a customer's e-mail address or name, the ListSearch operation returns, among other things, the list IDs of a customer's public lists. Typically, entering an e-mail address yields more targeted results than entering the customer's name because e-mail addresses are unique. Often, however, a customer's e-mail address is not known so their name is used in the operation.

The following ListSearch request returns the list ID for John Smith.

http://ecs.amazonaws.com/onca/xml?
  Service=AWSECommerceService&
  AWSAccessKeyId=[Access Key ID]&
  Operation=ListSearch&
  ListType=WishList&
  Name=John%20Smith

Notice that the blank space between the first and last names is URL-encoded as %20.

The following is a snippet of the XML response to the sample request.

<List>
  <ListId>BB4444444477</ListId>
  <ListURL>http://www.amazon.com/gp/registry/BB4444444477</ListURL>
  <ListType>WishList</ListType>
  <TotalItems>70</TotalItems>
  <TotalPages>7</TotalPages>
  <DateCreated>1999-10-06</DateCreated>
  <CustomerName>John Smith</CustomerName>
</List>

The response contains the list ID, list type, date the list was created, the URL of the list, as well as the number of items on the list. Notice that the preceding response contains the ListURL element. You can paste this URL in a browser and see the items on the customer's list. The URL for each list type is the same with the exception of the last value, which is the list ID. That means that whenever you have a list ID, you can display it immediately. For more information, see Lists.

To find out more about the items on the list, use the ListId value in ListLookup.