 | Feedback |  |
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:
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 | Required | |
|---|---|---|---|
CustomerId
|
An alphanumeric token assigned by Amazon that uniquely identifies a customer. Only one Default: None Valid Values: A valid customer ID. | Yes | |
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. Default: None | No | Integers between 1 and 10, inclusive. Default is 1. |
TagPage
| Specifies the page of results to return. There are ten results on a page. The maximum page number is 400. Default: None | No | Integer |
TagsPerPage
| The number of tags to return that are associated with a specified item. Default: None | No | Integer |
TagSort
|
Specifies the sorting order for the results. Default: - Usages Valid Values:
| No | |
ResponseGroup
|
Specifies the types of values to return. You can specify multiple response groups in one request by separating them with commas. Default: CustomerInfo Valid Values: CustomerReviews | CustomerLists | CustomerFull | TaggedGuides | TaggedItems | TaggedListmaniaLists | TagsSummary | Tags | No |
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
| Container 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. |
| Tags | Container for Tag elements. |
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=[AWS Access Key ID]& AssociateTag=[Associate ID]& Operation=CustomerContentLookup& CustomerId=[ID]
The response to this request is shown in, Response to Sample Request.
Find items tagged by a specific customer.
http://ecs.amazonaws.com/onca/xml? Service=AWSECommerceService& AWSAccessKeyId=[AWS Access Key ID]& AssociateTag=[Associate ID]& ResponseGroup=Tags& Marketplace=us& Version=2008-01-01& CustomerId=[Customer ID]& TagsPerPage=2& TagPage=2
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, and Wedding Registry, are made public automatically when customers create them. Private information, including street addresses, e-mail 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.
<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.
