Catalog Reviews

The Catalog Reviews web service returns products reviews posted on Kelkoo by our users. Reviews are important for users that want to know more about other people experiences with a particular product before deciding to buy the product themselves. This web service can provide a valuable research tool for the users of your web site.

Request Parameters

The Catalog Listing web service supports the following parameters:

Name Type Summary
catalogId numeric (required) The unique identifier of the catalog to return reviews for. Catalog Id’s can be obtained using Catalog Search or Product Search.
sort string (optional) Reviews can be sorted by the following parameters:

  • newest: the latest reviews will be shown first.
  • oldest: the oldest reviews will be shown first
  • mosthelpful: the most helpful reviews as voted by users will be shown first
  • leasthelpful: the least helpful reviews as voted by users will be shown first
  • highestrated: the reviews with the highest overall product rating will be shown first
  • lowestrated: the reviews with the lowest overall product rating will be shown first
start integer (optional) The position of the first review to return. Must be higher than 0 and less than the total number of reviews for the catalog.
results integer (optional) The number of Reviews to return. Must be higher than 0 and less than or equal to 10.

Response Element

Top level elements

Name Summary
NumRatings The number of users who have rated this catalog.
OverallRating The rating given by the reviewer for the product, from 0 to 5.
RecommendedProduct The number of people who found the review helpful.
Review Contains each individual review.
totalResultsAvailable Number of reviews available for this catalog.
firstResultPosition The position of the first review returned.
totalResultsReturned The number of reviews returned.

Review elements

Name Summary
Title The title of the review.
Reviewer The name of the reviewer.
CreateTime The date when the review was written.
Pros The pros (positive attributes) of the product as per the reviewer
Cons The cons (negative attributes) of the product as per the reviewer
Text The review written by the reviewer
URL The URL of the review on Kelkoo.
HelpfulRecommendations The number of people who found the review useful
TotalRecommendations The number of people who have read the review.
Rating Sub-rating for detailed component of the user review. Has an attribute ratingType, which specifies the name of the sub rating component

Sample Response

The following is a sample response when you search for the catalogID: 122701-18380481 with the service.

CatalogReviews firstResultPosition="1" sort="newest" totalResultsAvailable="3" totalResultsReturned="3">
<NumRatings>59</NumRatings>
<OverallRating>4.0</OverallRating>
<RecommendedProduct>83</RecommendedProduct>
−
<Review>
<Title>Excellent MP3 Player! But, it&amp;amp;#39;s a bit pricey!</Title>
<Reviewer>Christopher Temple</Reviewer>
<CreateTime>1219229788000</CreateTime>
−
<Pros>
High Quality Sound, Apple Earphones included, Lightweight, Sleek
</Pros>
<Cons>Bit Pricey!</Cons>
−
<Text>
This iPod Touch an absolute MUST for everyone looking for an MP3 Player! ...BUT, the price is a little to high in my opinion, I never would have got one if I never got mine for FREE. Luckily a friend recommended this website to me before I went and bought one:

*************************
www.justgetitfree.com
*************************

I checked out the website, completed ONE simple offer and met the requirements to receive one for FREE, and it arrived 3 weeks later in the post, ordered from Apple themselves! It was also shown on BBC and CNN news!!

I would never have been able to find the spare cash to spend on one of these, i&amp;amp;#39;m so glad that I was recommended www.justgetitfree.com to get one for FREE :D ! You can get one too!

I would recommend this to everyone if you want one of these but can&amp;amp;#39;t afford it then go to www.justgetitfree.com you wont regret it!
</Text>
−
<Url>
http://audiovisual.kelkoo.co.uk/prl_18380481/122701.html
</Url>
<HelpfulRecommendations>0</HelpfulRecommendations>
<TotalRecommendations>0</TotalRecommendations>
−
<Rating>
−
<RatingValues>
−
<RatingValue>
<Label>Overall Rating: </Label>
<Value>5</Value>
</RatingValue>
−
<RatingValue>
<Label>Sound Quality </Label>
<Value>5</Value>
</RatingValue>
−
<RatingValue>
<Label>Battery Life </Label>
<Value>5</Value>
</RatingValue>
−
<RatingValue>
<Label>Portability </Label>
<Value>5</Value>
</RatingValue>
−
<RatingValue>
<Label>Quality </Label>
<Value>5</Value>
</RatingValue>
−
<RatingValue>
<Label>Value for Money </Label>
<Value>2</Value>
</RatingValue>
</RatingValues>
</Rating>
</Review>
−
<Review>
<Title>www.obpshop.com</Title>
<Reviewer>Zhao Ming</Reviewer>
<CreateTime>1211462034000</CreateTime>
<Pros>www.obpshop.com</Pros>
<Cons>www.obpshop.com</Cons>
−
<Text>
Dear Sir/Madam,
	I&amp;amp;#39;m sorry to disturb you!
	There are thousands of goods in our company.Pls feel free to contact us if you are interested in any of them.
	Contacts: obpshop.com
	Email/MSN: obpshop(at)hotmail.com
</Text>
−
<Url>
http://audiovisual.kelkoo.co.uk/prl_18380481/122701.html
</Url>
<HelpfulRecommendations>0</HelpfulRecommendations>
<TotalRecommendations>1</TotalRecommendations>
−
<Rating>
−
<RatingValues>
−
<RatingValue>
<Label>Overall Rating: </Label>
<Value>1</Value>
</RatingValue>
−
<RatingValue>
<Label>Sound Quality </Label>
<Value>1</Value>
</RatingValue>
−
<RatingValue>
<Label>Battery Life </Label>
<Value>1</Value>
</RatingValue>
−
<RatingValue>
<Label>Portability </Label>
<Value>1</Value>
</RatingValue>
−
<RatingValue>
<Label>Quality </Label>
<Value>1</Value>
</RatingValue>
−
<RatingValue>
<Label>Value for Money </Label>
<Value>1</Value>
</RatingValue>
</RatingValues>
</Rating>
</Review>
−
<Review>
<Title>Best ipod apple have bought out yet!</Title>
<Reviewer>Claire Richardson</Reviewer>
<CreateTime>1201016047000</CreateTime>
−
<Pros>
looks smart , easy to use , wifi , good storage capacity
</Pros>
<Cons>marks easily</Cons>
−
<Text>
smashing peice of kit , more than you need really ! lloks real smart but i would recommend a cover of some sort as it picks up scratches and finger prints real easy.

i would recommend this product but if you cant afford one why not do what i did and get one for £5 from www.freeconsole.net
all i did was click the pic of the ipod , sign up to a website and complete an offer i did gala bingo like sharon osbourne lol , then i got a couple of friends to do the same and bang my ipod arrived via city link! this has been approved by the bbc and is the only way i could afford such luxuries give it a go www.freeconsole.net
</Text>
−
<Url>
http://audiovisual.kelkoo.co.uk/prl_18380481/122701.html
</Url>
<HelpfulRecommendations>0</HelpfulRecommendations>
<TotalRecommendations>0</TotalRecommendations>
−
<Rating>
−
<RatingValues>
−
<RatingValue>
<Label>Overall Rating: </Label>
<Value>4</Value>
</RatingValue>
−
<RatingValue>
<Label>Sound Quality </Label>
<Value>3</Value>
</RatingValue>
−
<RatingValue>
<Label>Battery Life </Label>
<Value>4</Value>
</RatingValue>
−
<RatingValue>
<Label>Portability </Label>
<Value>5</Value>
</RatingValue>
−
<RatingValue>
<Label>Quality </Label>
<Value>4</Value>
</RatingValue>
−
<RatingValue>
<Label>Value for Money </Label>
<Value>4</Value>
</RatingValue>
</RatingValues>
</Rating>
</Review>
−
<Warnings>
−
<Warning>
The "sort" parameter is not given. The default value "newest" is used.
</Warning>
−
<Warning>
The "start" parameter is not given. The default value "1" is used.
</Warning>
−
<Warning>
The "results" parameter is not given. The default value "20" is used.
</Warning>
</Warnings>
</CatalogReviews>

Related Web Services

Catalog Listings and Catalog Search