To show product reviews from Kieskeurig.nl on your own website 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.
Use the REST call below to show product reviews from Kieskeurig.nl on your own website. This REST call outputs an XML containing all review from a specific product and the total review score.
http://rest-ext.kieskeurig.nl/[token]/product.html?_a=reviews&product_id=[id]&ratings=[true/false]
In the mentioned REST call are three parameters which have to be filled in before you can use Kieskeurig.nl’s REST call.
parameter value mandatory
product_id product uid/EAN-code** yes
token access key yes
ratings true or false yes
[product_id]
The product’s id/uid as used in the Kieskeurig.nl product-URL. Or the product’s EAN-code. **
[token]
Unique key which provides access to the REST-call.
[ratings]
“True” returns all partial scores of the review, “false” only returns the total score.
** Product-id or EAN-code
It is highly recommended to use an EAN-code when calling the REST-API. Product-id’s tend to become obsolete over time in case a product is edited, while EAN-codes always return the correct product.
A product in Kieskeurig.nl’s database can have multiple EAN-codes. Any of these can be used to select the product.
<title>
<text> (completely)
<name>
<date>
<cijfer>
<section>”review_link”
<product_id>3334080</product_id>
<reviewspage>https://www.kieskeurig.nl/smartphone/samsung/galaxyj5(2016)/reviews/3334080/</reviewspage>
<body>
<metakeywords>Samsung Galaxy J5 (2016),..., mobieltjes ,..., GalaxyJ5(2016), SMJ510FZKNPHN</metakeywords>
<behaviorkind>hardware</behaviorkind>
<product>Samsung Galaxy J5 (2016)</product>
<pcode ati_id="14054" subtype="normal">gsm</pcode>
<merk>Samsung</merk>
<type>Galaxy J5 (2016)</type>
<ean>8806088416328</ean>
<lifecycle>normal</lifecycle>
<hits>17</hits>
<page>1</page>
<metadata>
<count/>
<count_consumer/>
<count_expert/>
</metadata>
<section name="review" id="5980698" review_link_id="5980698" review_link="https://www.kieskeurig.nl/smartphone/samsung/galaxyj5(2016)/reviews/3334080/tweakradje/5980698" approved="Y" recommend="N">
<text>Kom van een Samsung Core (2013) uit toen dezelfde prijsklasse. Uiteraard net als deze ook gelijk geroot. Vreemd dat qualcomm de snapdragon 410 cpu op minimaal 800 Mhz fixed, terwijl dat naar 200 Mhz kan. Ook core uitschakeling is niet geactiveerd. </text>
<text_raw>Kom van een Samsung Core (2013) uit toen dezelfde prijsklasse. Uiteraard net als deze ook gelijk geroot. Vreemd dat qualcomm de snapdragon 410 cpu op minimaal 800 Mhz fixed, terwijl dat naar 200 Mhz kan. Ook core uitschakeling is niet geactiveerd.</text_raw>
<date dt="2017-01-11T08:35:05">11-01-2017</date>
<name>tweakradje</name>
<title>Standaard goed toestel</title>
<link_url/>
<form>review</form>
<cijfer>8</cijfer>
<inbezit>paar weken</inbezit>
<pros>
<pro>beeldscherm</pro>
<pro>snel genoeg</pro>
<pro>gps perfect!</pro>
<pro>verwisselbare, grote accu</pro>
<pro>voelt stevig</pro>
</pros>
<cons>
<con>geen notificatie led, backlight toetsen</con>
<con>geen kompas, lichtsensor</con>
<con>Stock Camera matig, gebruik OpenCamera</con>
<con>Qualcomm cpu regeling slecht</con>
<con>matige achter speaker</con>
</cons>
</section>
<product_id>
The product’s id/uid.
<reviewspage>
Link to the product’s review-page.
<product>
Short description of the product.
<pcode>
Product category in which the product belongs.
<merk>
The product’s brand.
<type>
The product’s title.
<hits>
The product’s total number of reviews.
<section>”review_link_id”
The review’s id/uid.
<section>”review_link”
Link to the complete review.
<section>”approved”
Has the review been approved by Kieskeurig.nl.
<section>”recommend”
Have other consumers recommend this review.
<text>
Formatted text of the review.
<tekst_raw>
The review’s original text.
<date>
Date when the review was written.
<name>
The reviewer’s nickname.
<title>
The review’s title.
<cijfer>
The review’s total score.
<inbezit>
How long does the reviewer have said product in possession.
<pros><pro>
Positive aspects.
<cons><con>
Negative aspects.
REST-call
Use the REST call below to show product reviews from Kieskeurig.nl on your own website. This REST call outputs an XML containing all review from a specific product and the total review score.http://rest-ext.kieskeurig.nl/[token]/product.html?_a=reviews&product_id=[id]&ratings=[true/false]
Parameters
In the mentioned REST call are three parameters which have to be filled in before you can use Kieskeurig.nl’s REST call.parameter value mandatory
product_id product uid/EAN-code** yes
token access key yes
ratings true or false yes
Explanation of the parameters
[product_id]The product’s id/uid as used in the Kieskeurig.nl product-URL. Or the product’s EAN-code. **
[token]
Unique key which provides access to the REST-call.
[ratings]
“True” returns all partial scores of the review, “false” only returns the total score.
** Product-id or EAN-code
It is highly recommended to use an EAN-code when calling the REST-API. Product-id’s tend to become obsolete over time in case a product is edited, while EAN-codes always return the correct product.
A product in Kieskeurig.nl’s database can have multiple EAN-codes. Any of these can be used to select the product.
What to extract from the REST call
The REST call outputs an XML. From that XML, the following properties need to be shown at least in order to show reviews from Kieskeurig.nl correctly on your own web site.<title>
<text> (completely)
<name>
<date>
<cijfer>
<section>”review_link”
XML example
<resultset version="7.4.0.0" reqver_maj="2" reqver_min="9" build_date="2017-03-01 12:14"><product_id>3334080</product_id>
<reviewspage>https://www.kieskeurig.nl/smartphone/samsung/galaxyj5(2016)/reviews/3334080/</reviewspage>
<body>
<metakeywords>Samsung Galaxy J5 (2016),..., mobieltjes ,..., GalaxyJ5(2016), SMJ510FZKNPHN</metakeywords>
<behaviorkind>hardware</behaviorkind>
<product>Samsung Galaxy J5 (2016)</product>
<pcode ati_id="14054" subtype="normal">gsm</pcode>
<merk>Samsung</merk>
<type>Galaxy J5 (2016)</type>
<ean>8806088416328</ean>
<lifecycle>normal</lifecycle>
<hits>17</hits>
<page>1</page>
<metadata>
<count/>
<count_consumer/>
<count_expert/>
</metadata>
<section name="review" id="5980698" review_link_id="5980698" review_link="https://www.kieskeurig.nl/smartphone/samsung/galaxyj5(2016)/reviews/3334080/tweakradje/5980698" approved="Y" recommend="N">
<text>Kom van een Samsung Core (2013) uit toen dezelfde prijsklasse. Uiteraard net als deze ook gelijk geroot. Vreemd dat qualcomm de snapdragon 410 cpu op minimaal 800 Mhz fixed, terwijl dat naar 200 Mhz kan. Ook core uitschakeling is niet geactiveerd. </text>
<text_raw>Kom van een Samsung Core (2013) uit toen dezelfde prijsklasse. Uiteraard net als deze ook gelijk geroot. Vreemd dat qualcomm de snapdragon 410 cpu op minimaal 800 Mhz fixed, terwijl dat naar 200 Mhz kan. Ook core uitschakeling is niet geactiveerd.</text_raw>
<date dt="2017-01-11T08:35:05">11-01-2017</date>
<name>tweakradje</name>
<title>Standaard goed toestel</title>
<link_url/>
<form>review</form>
<cijfer>8</cijfer>
<inbezit>paar weken</inbezit>
<pros>
<pro>beeldscherm</pro>
<pro>snel genoeg</pro>
<pro>gps perfect!</pro>
<pro>verwisselbare, grote accu</pro>
<pro>voelt stevig</pro>
</pros>
<cons>
<con>geen notificatie led, backlight toetsen</con>
<con>geen kompas, lichtsensor</con>
<con>Stock Camera matig, gebruik OpenCamera</con>
<con>Qualcomm cpu regeling slecht</con>
<con>matige achter speaker</con>
</cons>
</section>
XML-nodes explained
<product_id>The product’s id/uid.
<reviewspage>
Link to the product’s review-page.
<product>
Short description of the product.
<pcode>
Product category in which the product belongs.
<merk>
The product’s brand.
<type>
The product’s title.
<hits>
The product’s total number of reviews.
<section>”review_link_id”
The review’s id/uid.
<section>”review_link”
Link to the complete review.
<section>”approved”
Has the review been approved by Kieskeurig.nl.
<section>”recommend”
Have other consumers recommend this review.
<text>
Formatted text of the review.
<tekst_raw>
The review’s original text.
<date>
Date when the review was written.
<name>
The reviewer’s nickname.
<title>
The review’s title.
<cijfer>
The review’s total score.
<inbezit>
How long does the reviewer have said product in possession.
<pros><pro>
Positive aspects.
<cons><con>
Negative aspects.