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.
- Name: Catalog Reviews
- Version: 3.0
- Path: /V2/catalogReviews
- Schemas: catalogreviews.xsd, common.xsd
- Markets: All markets
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:
|
| 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;#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;#39;m so glad that I was recommended www.justgetitfree.com to get one for FREE! You can get one too! I would recommend this to everyone if you want one of these but can&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;#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>