CustomerContentLookup

Description

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
Name
Nickname
Wedding Registry
WishList

To find a customer ID, use the CustomerContentSearch operation.

	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 `CustomerId` can be submitted at a time in `CustomerContentLookup`. 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: FirstUsed-Sort by the date the item was first used. - FirstUsed-Sort by the date the item was last used. LastUsed-Sort by the date the item was last used. - LastUsed-Sort by the date the item was first used. Name-Alphabetical, A-Z. - Name-Alphabetical, Z-A. Usages-Items least used to most used	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]
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

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
&Timestamp=[YYYY-MM-DDThh:mm:ssZ]
&Signature=[Request Signature]

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.

Related Operations

CustomerContentSearch