Implementing white label shop review on your own website

To show shop reviews from Kieskeurig.nl on your own web site you need access to Kieskeurig.nl’s REST API. Access to this API is controlled by a token which will be given to you by Kieskeurig.nl. If you also use the white label review iframe, you can use the same token to call the REST API.

Calling the REST API

Use the REST call below to show shop reviews from Kieskeurig.nl on your own web site. This REST call outputs an XML containing all review from a specific shop and the total review score.

http://rest-ext.kieskeurig.nl/nl/shop.nsf/reviews?shopid=[shop-id]&reviewtype=all&_version=3.10&_token=[token]

Parameters

In the mentioned REST call are two parameters which have to be filled in before you can use Kieskeurig.nl’s REST call.

parameter value mandatory
shop_id unique shop id yes
token access key yes

Explanation of the parameters

[shop_id] unique id of the shop
[token] unique key for accessing the REST call

What to extract from the REST call

The REST call outputs an XML. From that XML, the following properties need to be shown in order to show reviews from Kieskeurig.nl correctly on your own web site.

<text> (completely)
<name>
<date>
<gender> (if filled in)
<score>
<section>”review_link”

XML example

<resultset version=”7.4.0.0” reqver_maj=”3” reqver_min=”10” build_date=”2017-03-01 12:14”>
<dartcode>homepage</dartcode>
<stirgroup>home</stirgroup>
<stircode>ecommerce</stircode>
<stir4code/>
<reviewspage>https://www.kieskeurig.nl/alternate/winkelbeoordeling/B78D3425E5F554FCC1256C84003BFBE4</reviewspage>
<ShopInfoRecord online=”true”>
<ShopID>B78D3425E5F554FCC1256C84003BFBE4</ShopID>
<ShopIntro>
<ShopName>Alternate</ShopName>
<ShopLogo>https://media.kieskeurig.nl/images/01/32/87/b2/51cd/4c60/8c96/52dd7b6775c7/orig.png</ShopLogo>
<ShopImage/>
<ShopIntroText>Alternate is van oudsher een van de grotere online leveranciers can computers, computercomponenten en multimediaproducten in Europa. ... Vanuit Nederland is in 2007 ook in België (Aartselaar) een vestiging gestart, met vergelijkbaar succes.</ShopIntroText>
<ShopTotalReviewRating count=”50”>
<label>Beoordeling</label>
<value>6,5</value>
</ShopTotalReviewRating>
</Shopintro>
</ShopInfoRecord>
<hits>919</hits>
<page>1</page>
<section name=”review” id=”6017352” review_link_id=”6017352”
review_link =”https://www.kieskeurig.nl/alternate/winkelbeoordeling/uniek/adele_m/b78d3425e5f554fcc1256c84003bfbe4/6017352”
approved=”Y” recommend=”Y”>
<site>NL</site>
<text>Ik had n muis en toetsenbord besteld , alleen hadden ze de verkeerde toetsenbord gestuurd , maar zonder problemen kon dit omgeruild worden. als ik weer wat nodig mocht hebben zal ik hier zeker weer bestellen.</text>
<title>goede service</title>
<location physical=”false”/>
<date dt=”2017-03-02T13:53:33”>02-03-2017</date>
<name>adele m</name>
<form>review</form>
<cijfer>7</cijfer>
<stericon>ster30_red</stericon>
<part>
<label>Gemak</label>
<value>8</value>
</part>
<part>
<label>Service</label>
<value>8</value>
</part>
<part>
<label>Levering</label>
<value>8</value>
</part>

<part>
<label>Levertijd</label>
<value>6</value>
</part>
<part>
<label>Afleverservice</label>
<value>10</value>
</part>
<part>
<label>Verzendkosten</label>
<value>8</value>
</part>
<part>
<label>Retourproces</label>
<value>10</value>
</part>
<part>
<label>Klantenservice</label>
<value>8</value>
</part>
<part>
<label>Betaalmogelijkheden</label>
<value>8</value>
</part>
<part>
<label>Gebruiksvriendelijkheid site</label>
<value>8</value>
</part>
</section>

XML-nodes explained

<reviewspage>
link to the shop reviews listing page

<ShopTotalReviewRating> “count”
total number of shop reviews which are valid for the shop score

<ShopTotalReviewRating> / <value> / totaal reviewcijfer
main score of the review

<hits>
total number of reviews

<section>”review_link_id”
ID/UID of the review

<section>”review_link”
link to the complete review at Kieskeurig.nl

<section>”approved”
Y = review has been approved by Kieskeurig.nl

<section>”recommend”
Y = review has been recommended by other customers

<text>
formatted text of the review

<tekst_raw>
original text of the review

<date>
date when the review was written

<name>
username of the reviewer

<title>
title of the review

<cijfer>
total score of the review

<pros><pro>
positive aspects

<cons><con>
negative aspects

Questions

If you have any questions, you can send them to datamanagement@kieskeurig.nl.