bol.com Product API
What can you do with the bol.com Product API?
- Scrape all resellers of a product in any bol.com country
- Scrape prices of all sellers in any bol.com country based on the EAN code
 Register now and get 100 credits for free! |
|
API response
| request_id | unique ShoppingScraper request_id | |
| query link | link | the requested url from ShoppingScraper |
| ean | the requested EAN code | |
| endpoint | type | endpoint used |
| app | chosen bol.com app | |
| metadata | additional metadata to be used for your own internal references | |
| geo | country | selected country for request |
| |
language | selected language |
| status | response | server response from the request (200/404/500) |
| message | status message from the request | |
| stats | results | number of sellers found for this EAN |
| timestamp | record of the time of the request | |
| pagespeed | amount of seconds of request | |
| results | classification | type of data returned |
| title | matched product title with EAN | |
| brand | brand of the product | |
| category | bread crumb of the product | |
| ean | requested EAN | |
| extended | additional EAN codes how this product can be identified | |
| stats offers | number of offers found for this | |
| sku | bol.com product id or doc id | |
| currency | used currency of country | |
| stats offers | number of sellers found for this EAN |
|
| offers price | price of product at specific seller offer | |
| offers shipment | shipment type of seller offer | |
| offers shippingCosts | shipping costs of specific seller offer | |
| offers totalPrice | total price incl. shipping of specific seller offer | |
| offers seller | seller name | |
| offers seller_id and seller_info | seller id from bol.com to use for seller endpoint and link to seller information | |
| offers availability | availability of specific product offer | |
| offers promise | delivery promise of the product | |
| offers state | state of specific product offer | |
| offers ranking | ranking of product offer | |
| content description | description found on bol.com | |
| content images thumbnail | thumbnail image found | |
| reviews count | total count of number of reviews | |
| |
reviews scale | maximum scale |
| |
reviews rating | average rating of the product |
| buybox price |
price excl. shipping | |
| buybox shippingCosts |
shipping costs of product | |
| buybox totalPrice |
total price of product incl. shipping | |
| buybox seller |
the owner of the buybox | |
| buybox state | state of the product of the buy box owener | |
| buybox link | the url to the website of the buybox owner |
Parameters
| |
Description | Example values |
| metadata | Add your own metadata to your request, will be added to the payload | internal product id = 5555 |
| 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 😉 |
| content | Adds the content description and thumbnail | true or false |
| sellers | Adds all sellers and buy box information |
true or false |
Matching
We only return data if we are 100% certain. We match products based on the EAN/GTIN code on bol.com
Sample URL
https://api.shoppingscraper.com/product/bolcom/{COUNTRY_CODE}/{EAN_GTIN}?api_key={API_KEY}&content={TRUE_FALSE}&sellers={TRUE_FALSE}&metadata={producitd:5555}
Sample payload
"shoppingscraper": {
"request_id": "70b85b3c-41a2-4f1b-b9ad-f38456c3b7ec",
"query": {
"link": "http://api.shoppingscraper.com/product/bolcom/nl/8714649003200?&sellers=true&content=true&api_key=xxxxxxx",
"ean": "8714649003200"
}, "endpoint": {
"type": "product",
"app": "bol.com"
},
"metadata": {
},
"geo": {
"country": "nl",
"language": "Unknown"
},
"status": {
"response": 200,
"message": "OK"
},
"stats": {
"results": 1,
"timestamp": "Tue Sep 09 2022 07:20:21 UTC+0000",
"pagespeed": 3.17
},
"results": [
{
"classification": "product",
"title": "Nijntje Verstoppertje spelen",
"brand": "Identity Games",
"category": [
{
"name": "Home",
"url": "/nl/nl/"
},
{
"name": "Speelgoed",
"url": "/nl/nl/l/speelgoed/7934/"
},
{
"name": "Baby & Peuter",
"url": "/nl/nl/l/baby-peuterspeelgoed/10477/"
},
{
"name": "Spelletjes",
"url": "/nl/nl/l/baby-en-kleuterspelletjes/10493/"
}
],
"ean": "8714649003200",
"extended": {
},
"sku": "1004004013233974",
"currency": "EUR",
"ranking": {
},
"stats": {
"offers": 10
},
"offers": [
{
"price": 17.99,
"shipment": "standard",
"shippingCosts": 2.99,
"totalPrice": 20.98,
"seller": "Bol.com",
"availability": "InStock",
"promise": [
"Op voorraad. Voor 23:59 besteld, morgen in huis"
],
"state": "New",
"ranking": {
"productList": 1
}
},
{
"price": 20.12,
"shipment": "standard",
"shippingCosts": 0.0,
"totalPrice": 20.12,
"seller": "ACSI NV.",
"availability": "InStock",
"promise": [
"Uiterlijk 9 september in huis"
],
"state": "New",
"ranking": {
"productList": 2
},
"link": "https://bol.com/nl/nl/v/acsi-nv/1068037/?sellingOfferId=c09e16a37025de092fe322d9b023af75",
"sellerId": "1068037",
"sellerInfo": "https://api.shoppingscraper.com/seller/1068037?app=bolcom&country=nl&language"
},
{
"price": 21.99,
"shipment": "standard",
"shippingCosts": 0.0,
"totalPrice": 21.99,
"seller": "Meeples Bordspellen",
"availability": "InStock",
"promise": [
"Op voorraad. Voor 15:30 uur besteld, morgen in huis"
],
"state": "New",
"ranking": {
"productList": 3
},
"link": "https://bol.com/nl/nl/v/meeples-bordspellen/1462497/?sellingOfferId=581fcea2a50e9c767dd7eaf336a16428",
"sellerId": "1462497",
"sellerInfo": "https://api.shoppingscraper.com/seller/1462497?app=bolcom&country=nl&language"
},
{
"price": 22.95,
"shipment": "standard",
"shippingCosts": 0.0,
"totalPrice": 22.95,
"seller": "SpellenRijk.nl",
"availability": "InStock",
"promise": [
"Op voorraad. Voor 21:00 uur besteld, morgen in huis"
],
"state": "New",
"ranking": {
"productList": 4
},
"link": "https://bol.com/nl/nl/v/spellenrijk-nl/923981/?sellingOfferId=0e5ea7eb15dbfbc4e61d2153e5aa41ad",
"sellerId": "923981",
"sellerInfo": "https://api.shoppingscraper.com/seller/923981?app=bolcom&country=nl&language"
},
{
"price": 23.99,
"shipment": "standard",
"shippingCosts": 0.0,
"totalPrice": 23.99,
"seller": "Lobbes.nl",
"availability": "InStock",
"promise": [
"Op voorraad. Voor 16:00 uur besteld, morgen in huis"
],
"state": "New",
"ranking": {
"productList": 5
},
"link": "https://bol.com/nl/nl/v/lobbes-nl/707274/?sellingOfferId=310ea74c0a08749d5508f2970160a68d",
"sellerId": "707274",
"sellerInfo": "https://api.shoppingscraper.com/seller/707274?app=bolcom&country=nl&language"
},
{
"price": 24.99,
"shipment": "standard",
"shippingCosts": 0.0,
"totalPrice": 24.99,
"seller": "DVDOutlet.nl",
"availability": "InStock",
"promise": [
"Uiterlijk 8 september in huis"
],
"state": "New",
"ranking": {
"productList": 6
},
"link": "https://bol.com/nl/nl/v/dvdoutlet-nl/671238/?sellingOfferId=b0a3c9709486199742bb5f66e77a42cf",
"sellerId": "671238",
"sellerInfo": "https://api.shoppingscraper.com/seller/671238?app=bolcom&country=nl&language"
},
{
"price": 25.75,
"shipment": "standard",
"shippingCosts": 0.0,
"totalPrice": 25.75,
"seller": "Wohi",
"availability": "InStock",
"promise": [
"Uiterlijk 13 september in huis"
],
"state": "New",
"ranking": {
"productList": 7
},
"link": "https://bol.com/nl/nl/v/wohi/1239264/?sellingOfferId=ae54364c6adbaa045f04ba355c13bfcf",
"sellerId": "1239264",
"sellerInfo": "https://api.shoppingscraper.com/seller/1239264?app=bolcom&country=nl&language"
},
{
"price": 25.86,
"shipment": "standard",
"shippingCosts": 0.0,
"totalPrice": 25.86,
"seller": "Dobeno",
"availability": "InStock",
"promise": [
"Uiterlijk 9 september in huis"
],
"state": "New",
"ranking": {
"productList": 8
},
"link": "https://bol.com/nl/nl/v/dobeno/925531/?sellingOfferId=087fc13a52d57f1f4d3755330ee0a4c2",
"sellerId": "925531",
"sellerInfo": "https://api.shoppingscraper.com/seller/925531?app=bolcom&country=nl&language"
},
{
"price": 25.95,
"shipment": "standard",
"shippingCosts": 0.0,
"totalPrice": 25.95,
"seller": "SpeelgoedDeals.com",
"availability": "InStock",
"promise": [
"Op voorraad. Voor 16:00 uur besteld, morgen in huis"
],
"state": "New",
"ranking": {
"productList": 9
},
"link": "https://bol.com/nl/nl/v/speelgoeddeals-com/877052/?sellingOfferId=9014780e26c3cc95162bc564f651ee41",
"sellerId": "877052",
"sellerInfo": "https://api.shoppingscraper.com/seller/877052?app=bolcom&country=nl&language"
},
{
"price": 25.99,
"shipment": "standard",
"shippingCosts": 0.0,
"totalPrice": 25.99,
"seller": "Speelgoedwonder",
"availability": "InStock",
"promise": [
"Op voorraad. Nu besteld, morgen in huis"
],
"state": "New",
"ranking": {
"productList": 10
},
"link": "https://bol.com/nl/nl/v/speelgoedwonder/1398826/?sellingOfferId=643f10efbcdd03c681f2a9249e199456",
"sellerId": "1398826",
"sellerInfo": "https://api.shoppingscraper.com/seller/1398826?app=bolcom&country=nl&language"
}
],
"thumbnail": "https://media.s-bol.com/36AmB98GP13Q/168x179.jpg",
"buybox": {
"link": "https://www.bol.com/nl/nl/p/nijntje-verstoppertje-spelen/1004004013233974/",
"price": "17.99",
"seller": "bol.com",
"shippingCosts": 0.0,
"state": "inStock",
"totalPrice": "17.99"
}
}
]
}
}