What can you do with the bol.com reviews API?
- Scrape reviews about the bol.com seller
- Scrape reviews of a product based on EAN code
API response
| endpoint | type | endpoint used |
| url | used url to get data from | |
| geo | country | selected country for request |
| status | response | server response from the request (200/404/500) |
| message | status message from the request | |
| next_page | 1,2,3,4 | numerical value for next page |
| results | title | title of review |
| author name, age, city, date, verified | review data on bol.com | |
| positive | all positive points | |
| negative | all negative points | |
| user feedback | location of review writer | |
Parameters
| Description | Example values | |
| seller_id | The unique id at bol.com that identifies a seller | 1556216 |
| country_code | Any ISO 3166-1 country code where bol.com is active | nl or be |
| ean_gtin | Identify any product with EAN/GTIN code | 190198512154 or 5702016368635 |
| api_key | Your ShoppingScraper API key | no example to show here 😉 |
Matching
We only return data if we are 100% certain. We match reviews based on the EAN or seller ID on bol.com
Sample URL
https://api.shoppingscraper.com/reviews/{EAN}?app=bolcom&country={COUNTRYCODE}&language={LANGUAGECOUNTRYCODE}&page={PAGE_NUMBER}&api_key={API_KEY}
or
https://api.shoppingscraper.com/reviews/{SELLER_ID}?app=bolcom&country={COUNTRYCODE}&language={LANGUAGECOUNTRYCODE}&page={PAGE_NUMBER}&api_key={API_KEY}
Sample payload
{
shoppingscraper: {
endpoint: {
type: "reviews",
url: "https://www.bol.com/nl/nl/p/princess-236017-waterkoker-zwart/9200000079737727/"
},
geo: {
country: "nl"
},
status: {
response: 200,
message: "OK"
},
next_page: 2,
results: [
[
{
title: "Lampje in transparante knop defect, zit waterdamp in na half jaar?!",
author: {
name: "Schoonhoven",
age: "30-39 jaar",
city: null,
date: "22 oktober 2020",
verified: "Heeft dit artikel gekocht"
},
positive: [
"doet wat het moet doen voor degelijke prijs",
"prettig deksel",
"filter in schenktuit werkt goed",
"filter in schenktuit kan los om schoon te maken",
"gladde binnenbodem geen kookelement"
],
negative: [
"bouwkwaliteit",
"lampje defect na half jaar normaal gebruik"
],
location: null,
review: "De waterkoker is wat je ervan kunt verwachten: niet de beste bouwkwaliteit maar doet wat hij moet doen. Het scharnier van de deksel zit halverwege het deksel wat aanvankelijk onhandig lijkt, maar het voordeel is dat waterdamp dat van het deksel zou kunnen afrollen bij het openen van het deksel gewoon *in* de waterkoker rolt in plaats van langs de waterkoker. Het deksel opent en sluit prettig. -----Geen herrieding, gewoon geluid wat je verwacht van kokend water (een pan kokend water is ook niet stil). -----Een halve liter water (het minimum) koud uit de kraan getapt kookt in exact 2 minuten. -----Het lukt ons om te schenken zonder te lekken, maar je moet wel schenken met overtuiging, anders lek je dus wel. -----De waterkoker heeft niet 1 vaste positie maar kan in 360 graden op de voet gezet worden, niet een heel unieke eigenschap maar zeker eentje die we niet meer willen missen in een eventuele volgende waterkoker. -----De aan- en uitknop is een ander verhaal. Er zit best veel weerstand in die knop: je klikt 'm niet zomaar aan, wat ook wel een stukje veiligheid betekent natuurlijk want hij kan niet per ongeluk aangezet worden. Duurde even voor we daar aan gewend waren, aanvankelijk waren we bang dat we iets zouden slopen. Het felle blauwe lampje in die transparante knop is natuurlijk de bevestiging dat je 'm goed hebt aangezet.Echter na een half jaar dagelijks gebruik (aankoop begin maart 2020, het is nu oktober 2020) is het lampje stuk. Er blijkt waterdamp in de knop te zitten?! We hebben de waterkoker gewoon netjes en normaal gebruikt, niet ondergedompeld om schoon te maken of wat dan ook. De opening rondom de schakelaar had best een flexibel rubber mogen hebben om dit te voorkomen. Onprettig idee dat er water *in* elektronica kan komen. Om deze reden zou ik de waterkoker dus ook NIET aanraden, want dit hoort niet zo makkelijk te kunnen.",
user_feedback: {
positive: "13",
negative: "1"
}
},
{
title: "Hele prettige waterkoker",
author: {
name: "Jacobien25",
age: "30-39 jaar",
city: "Amsterdam",
date: "18 september 2018",
verified: "Heeft dit artikel gekocht"
},
positive: [
"Goede kwaliteit",
"Goede prijs/kwaliteit",
"Voordelige koop"
],
negative: [],
location: null,
review: "Super fijne en snelle waterkoker, handig met goed lichtje bij aanknop.",
user_feedback: {
positive: "10",
negative: "1"
}
},
{
title: "Top waterkokertje",
author: {
name: "Zwalmpje1",
age: "40-49 jaar",
city: "Zwalm",
date: "3 september 2019",
verified: null
},
positive: [
"Goede prijs/kwaliteit"
],
negative: [],
location: null,
review: "Goede waterkoker. Vlot kokend water. En ook een handig knopje om de klep van de waterkoker open te doen, zo brandt je je niet aan de stoom. Prijs kwaliteit zeker een aanrader",
user_feedback: {
positive: "6",
negative: "0"
}
},
{
title: "Top ding voor kleine prijs",
author: {
name: "Max1020",
age: "20-29 jaar",
city: "Schagen",
date: "16 april 2019",
verified: "Heeft dit artikel gekocht"
},
positive: [
"Goede kwaliteit",
"Goede prijs/kwaliteit",
"Voordelige koop"
],
negative: [],
location: null,
review: "Top ding voor een hele kleine prijs. Water kookt snel en neemt weinig ruimte in. Als die dubbel zo duur was had ik de waterkoker alsnog gekocht.",
user_feedback: {
positive: "8",
negative: "2"
}
},
{
title: "Prima waterkoker",
author: {
name: "Equino4",
age: "30-39 jaar",
city: "westerland",
date: "30 juli 2018",
verified: "Heeft dit artikel gekocht"
},
positive: [
"Goede prijs/kwaliteit"
],
negative: [],
location: null,
review: "Prima waterkoker voor nette prijs. Maakt weinig geluid, design is mooi.",
user_feedback: {
positive: "9",
negative: "3"
}
},
{
title: "Goede waterkoker voor goede prijs",
author: {
name: "yasmijn27",
age: "40-49 jaar",
city: null,
date: "12 november 2019",
verified: null
},
positive: [
"Goede kwaliteit",
"Goede prijs/kwaliteit",
"Voordelige koop"
],
negative: [],
location: null,
review: "Mooie goede snelle waterkoker voor een fijne prijs!",
user_feedback: {
positive: "5",
negative: "0"
}
},
{
title: "Zeer goed",
author: {
name: "Sjakie56",
age: null,
city: null,
date: "8 oktober 2019",
verified: "Heeft dit artikel gekocht"
},
positive: [
"Goede prijs/kwaliteit",
"Voordelige koop"
],
negative: [],
location: null,
review: "Prima waterkoker, maakt weinig geluid",
user_feedback: {
positive: "4",
negative: "0"
}
},
{
title: "Waterkoker blijft stinken",
author: {
name: "Kees1857",
age: "60-69 jaar",
city: "Rosmalen",
date: "29 januari 2018",
verified: "Heeft dit artikel gekocht"
},
positive: [
"Voordelige koop"
],
negative: [],
location: null,
review: "De waterkoker blijft bij verhitting naar heet kunststof ruiken. Vraag mij af kunstof delen ookopgelost in je thee zitten",
user_feedback: {
positive: "14",
negative: "8"
}
},
{
title: "Erg lawaaierig en langzaam",
author: {
name: "Paula0264",
age: "50-59 jaar",
city: "Doesburg",
date: "28 januari 2020",
verified: "Heeft dit artikel gekocht"
},
positive: [],
negative: [
"Matige kwaliteit",
"erg lawaaierig ding."
],
location: null,
review: "De waterkoker is luid en vrij langzaam. Soms maakt hij een fluitend geluid dan weer niet.Water wordt wel goed warm.",
user_feedback: {
positive: "5",
negative: "1"
}
},
{
title: "Heel prettig",
author: {
name: "Zcha",
age: null,
city: null,
date: "21 augustus 2019",
verified: "Heeft dit artikel gekocht"
},
positive: [
"Goede kwaliteit",
"Goede prijs/kwaliteit",
"Voordelige koop",
"snelle levering"
],
negative: [],
location: null,
review: "Licht, klein, neemt niet te veel ruimte in beslag en er kan ook 1,7 liter water in. Goede prijs!",
user_feedback: {
positive: "3",
negative: "0"
}
}
]
]
}
}