For a given customer ID, the CustomerContentLookup operation retrieves all of the information a customer has made public about themselves on Amazon. Such information includes some or all of the following:
AboutMe
Birthday
City, State and Country
Customer Reviews
Customer ID
Listmania
Name
Nickname
Wedding Registry
WishList
To find a customer ID, use the
CustomerContentSearch
operation.
The following table describes the request parameters for CustomerContentLookup. Parameter names are case sensitive.
| Parameter | Definition | Req'd? | Valid Values |
|---|---|---|---|
CustomerId
| An alphanumeric token assigned by Amazon that uniquely identifies a customer. Only one CustomerId can be submitted at a time in CustomerContentLookup. | Yes | A valid customer ID. |
ReviewPage
| A positive integer that specifies the page of reviews to read. There are ten reviews per page. For example, to read reviews 11 through 20, specify ReviewPage=2. The total number of pages is returned in the TotalPages response tag. | No | Integers between 1 and 10, inclusive. Default is 1. |
ResponseGroup
| Specifies the types of values to return. You can specify multiple response groups in one request by separating them with commas. | No |
Request (Default) CustomerInfo (Default) |
CustomerContentLookup also accepts the parameters that all operations can use. For more information, see, Common Request Parameters
The following table describes the default response tags included in CustomerContentLookup responses.
| Element Tag | Definition |
|---|---|
Customer
| Containter for information about a Customer, for example, their NickName. |
Customers
| Container for Customer. |
Nickname
| The NickName the customer entered on their Your Account web page. |
For more information about the parent elements of these tags, see the appropriate response group in Response Groups
Use CustomerContentLookup in the following ways:
Return public information about a customer.
http://ecs.amazonaws.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[Access Key ID]& AssociateTag=[Your Associate ID Here]& Operation=CustomerContentLookup& CustomerId=[ID]
The response to this request is shown in, Response to Sample Request, below.
Use the CustomerReviews response group to display reviews written by the customer.
Use the CustomerLists response group to display the customer’s list IDs You can then use those IDs to display the customer’s lists.
Use the CustomerFull response group to display all of the public information about a customer including the customer’s birthday, the About Me message that appears on each Amazon customer's member page on Amazon, as well as all of the information returned by the CustomerInfo, CustomerLists, and CustomerReviews response groups.
Most of the customer's information, by default, is not available to CustomerContentLookup. Customers can use their Your Account page to make this information accessible. Public lists, however, such as a WishList, Wedding Registry, and Listmania, are made public automatically when customers create them. Private information, including street addresses, Email addresses, account transactions, and billing information are never returned.
The amount of information returned by CustomerContentLookup varies according to the response groups chosen and the amount of data made available by the customer. The following XML is a snippet of the full response to the first sample request above.
<Customer>
<CustomerId>[ID]</CustomerId>
<CustomerReviews>
<TotalReviews>8</TotalReviews>
<TotalReviewPages>1</TotalReviewPages>
<Review>
<ASIN>6305692688</ASIN>
<Rating>1</Rating>
<HelpfulVotes>21</HelpfulVotes>
<TotalVotes>35</TotalVotes>
<Date>2000 02 29</Date>
<Summary>one star is indeed one too many</Summary>
<Content>Let's face facts. This is a terrible, terrible movie. Don’t waste your time or money.</Content>
</Review>
</Customer>Only the customer's nickname and location were made public by the customer. At this point, they have not created publicly-accessed lists, such as a Listmania list.