CustomerContentLookup
Description
To find a customer ID, use the
CustomerContentSearch
operation.
![[Important]](important.png)
|
Important |
|---|---|
|
You must never display customer IDs publicly. You may use them in requests only to look up information. You may associate that information with a customer's name or nickname but never his or her customer ID. |
Availability
US, DE, FR, JP, and UK
Request Parameters
| Name | Description | Required |
|---|---|---|
CustomerId
|
An alphanumeric token assigned by Amazon that uniquely identifies a customer.
Only one Type: String 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. Type: Integers between 1 and 10, inclusive. Default is 1. Default: None |
No |
TagPage
|
Specifies the page of results to return. There are ten results on a page. The
maximum page number is 400. Type: Integer Default: None |
No |
TagsPerPage
|
The number of tags to return that are associated with a specified item.
Type: Integer Default: None |
No |
TagSort
|
Specifies the sorting order for the results. Type: String 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. Type: String 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
Response
| Name | Description |
|---|---|
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
Examples
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.
Sample Response
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.