v10 - Products - Demo Endpoints
Get best offers for items in sold in BE in MODERATE condition
Retrieves only the best offer offers available in Belgium for a specific EAN. It will only return offers in moderate condition.
GET /retailer-demo/products/5035223124276/offers?page=1&country-code=BE&best-offer-only=true&condition=MODERATE
-
Request
-
Response
Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)
This endpoint has no request body.
Content-Type: application/vnd.retailer.v10+json
Status: 200 OK
{
"offers" : [ {
"offerId" : "908b6d06-2067-4klf-8490-c21d0c233e61",
"retailerId" : "8748934",
"countryCode" : "BE",
"bestOffer" : true,
"price" : 36.59,
"fulfilmentMethod" : "FBR",
"condition" : "MODERATE",
"ultimateOrderTime" : "19:00",
"minDeliveryDate" : "2022-05-18",
"maxDeliveryDate" : "2022-05-23"
} ]
}
Get ALL available offers for items sold in NL
Retrieves all available offers available for for a specific EAN in The Netherlands. It returns both new and second-hand offers.
GET /retailer-demo/products/9789463160315/offers?page=1&country-code=NL&best-offer-only=false&condition=ALL
-
Request
-
Response
Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)
This endpoint has no request body.
Content-Type: application/vnd.retailer.v10+json
Status: 200 OK
{
"offers" : [ {
"offerId" : "228b6d06-2067-4cef-8447-c21d0c233e61",
"retailerId" : "738903",
"countryCode" : "NL",
"bestOffer" : true,
"price" : 41.5,
"fulfilmentMethod" : "FBB",
"condition" : "NEW",
"ultimateOrderTime" : "23:59",
"minDeliveryDate" : "2022-10-20",
"maxDeliveryDate" : "2022-10-21"
}, {
"offerId" : "92b7c257-a977-5cf7-e053-3c82010a92f3",
"retailerId" : "1448179",
"countryCode" : "NL",
"bestOffer" : false,
"price" : 48.45,
"fulfilmentMethod" : "FBR",
"condition" : "AS_GOOD",
"ultimateOrderTime" : "00:00",
"minDeliveryDate" : "2022-10-25",
"maxDeliveryDate" : "2022-10-26"
} ]
}
Get PRIMARY image for product
Get a the PRIMARY image for the specific EAN.
GET /retailer-demo/products/5035223124276/assets?usage=PRIMARY
-
Request
-
Response
Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)
This endpoint has no request body.
Content-Type: application/vnd.retailer.v10+json
Status: 200 OK
{
"assets" : [ {
"usage" : "PRIMARY",
"order" : 0,
"variants" : [ {
"size" : "small",
"width" : 250,
"height" : 200,
"mimeType" : "image/jpeg",
"url" : "https://media.s-bol.com/mkjdlmV9w5R0/8lB005/250x200.jpg"
}, {
"size" : "medium",
"width" : 500,
"height" : 700,
"mimeType" : "image/jpeg",
"url" : "https://media.s-bol.com/mkjaskV9w5R0/8lB005/500x700.jpg"
} ]
} ]
}
Get list of categories in 'nl'
Get a list of categories by using the accept language as 'nl'.
GET /retailer-demo/products/categories
-
Request
-
Response
Accept: application/vnd.retailer.v10+json
Content-Type: application/vnd.retailer.v10+json
Authorization: Bearer token (omitted)
Accept-Language: nl
This endpoint has no request body.
Content-Type: application/vnd.retailer.v10+json
Content-Language: nl
Status: 200 OK
{
"categories" : [ {
"categoryId" : "43646",
"categoryName" : "Auto & Motor",
"order" : 1,
"subcategories" : [ {
"categoryId" : "43647",
"categoryName" : "Autoaccessoires",
"subcategories" : [ {
"categoryId" : "15555",
"categoryName" : "Veilig onderweg",
"order" : 1,
"subcategories" : [ {
"categoryId" : "39900",
"categoryName" : "Veiligheidshamers",
"order" : 1
}, {
"categoryId" : "43779",
"categoryName" : "Anti-diefstalvergrendelingen",
"order" : 2,
"subcategories" : [ {
"categoryId" : "43956",
"categoryName" : "Kluizen",
"order" : 1
}, {
"categoryId" : "43954",
"categoryName" : "Wielklemmen",
"order" : 2
}, {
"categoryId" : "43955",
"categoryName" : "Pedaalsloten",
"order" : 3
}, {
"categoryId" : "43953",
"categoryName" : "Stuursloten",
"order" : 4
} ]
} ]
} ]
} ]
} ]
}
Get product ids by EAN
Gets the bol product id and related EANs for the EAN 8712836327641.
GET /retailer-demo/products/8712836327641/product-ids
-
Request
-
Response
Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)
This endpoint has no request body.
Content-Type: application/vnd.retailer.v10+json
Status: 200 OK
{
"bolProductId" : "9200000045327288",
"eans" : [ {
"ean" : "8712836327641"
}, {
"ean" : "8712836327658"
} ]
}
Get list of products in French in BE
Get a list of products in Belgium for search term 'stickers' that have a product rating between 1 and 4 stars in are in category 'Stickers & Tapes' (category id 38386).
POST /retailer-demo/products/list
-
Request
-
Response
Accept: application/vnd.retailer.v10+json
Content-Type: application/vnd.retailer.v10+json
Authorization: Bearer token (omitted)
Accept-Language: fr-BE
{
"countryCode" : "BE",
"searchTerm" : "STICKERS",
"categoryId" : "38386",
"filterRanges" : [ {
"rangeId" : "RATING",
"min" : 1,
"max" : 4
} ]
}
Content-Type: application/vnd.retailer.v10+json
Content-Language: fr-BE
Status: 200 OK
{
"products" : [ {
"title" : "Fille avec ballon, autocollant de voiture",
"eans" : [ {
"ean" : "9343929000678"
} ]
}, {
"title" : "Stickers muraux étoiles FRA1108",
"eans" : [ {
"ean" : "8020912014300"
} ]
} ],
"sort" : "POPULARITY"
}
Get list of products by category id
Get a list of products by category id sorted by RELEVANCE in NL.
POST /retailer-demo/products/list
-
Request
-
Response
Accept: application/vnd.retailer.v10+json
Content-Type: application/vnd.retailer.v10+json
Authorization: Bearer token (omitted)
Accept-Language: nl
{
"countryCode" : "NL",
"categoryId" : "10505",
"sort" : "RELEVANCE",
"page" : 1
}
Content-Type: application/vnd.retailer.v10+json
Content-Language: nl
Status: 200 OK
{
"products" : [ {
"title" : "Robotime modelbouw Miniatuur bouwpakket Cathy's Flower House hout/papier/kunststof - 195mm hoog x 175mm breed x 175mm diep - met lampje",
"eans" : [ {
"ean" : "8718274546071"
}, {
"ean" : "6946785108736"
} ]
}, {
"title" : "STABILO Power - Viltstift - Tot 8 Weken Zonder Dop - Etui Met 30 Kleuren",
"eans" : [ {
"ean" : "3168070280306"
} ]
} ],
"sort" : "RELEVANCE"
}
Get list of products by search term in BE
Get a list of products for search term LEGO, sorted by RELEVANCE in Belgium.
POST /retailer-demo/products/list
-
Request
-
Response
Accept: application/vnd.retailer.v10+json
Content-Type: application/vnd.retailer.v10+json
Authorization: Bearer token (omitted)
Accept-Language: nl-BE
{
"countryCode" : "BE",
"searchTerm" : "LEGO",
"filterRanges" : [ {
"rangeId" : "RATING",
"min" : 1,
"max" : 4
} ],
"sort" : "RELEVANCE",
"page" : 1
}
Content-Type: application/vnd.retailer.v10+json
Content-Language: nl-BE
Status: 200 OK
{
"products" : [ {
"title" : "LEGO Marvel Super Heroes 2 - Switch",
"eans" : [ {
"ean" : "5051888230589"
} ]
}, {
"title" : "LEGO: Harry Potter Jaren 5-7",
"eans" : [ {
"ean" : "5051888111673"
}, {
"ean" : "5051888079454"
}, {
"ean" : "5051895082645"
} ]
} ],
"sort" : "RELEVANCE"
}
Get list of product list filters for category 10505
Get product list filters for category 'Hobby & Creatief' that has category id 10505.
GET /retailer-demo/products/list-filters?country-code=NL&category-id=10505
-
Request
-
Response
Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)
Accept-Language: nl
This endpoint has no request body.
Content-Type: application/vnd.retailer.v10+json
Content-Language: nl
Status: 200 OK
{
"categoryData" : {
"categoryName" : "Categorieën",
"categoryValues" : [ {
"categoryValueId" : "38386",
"categoryValueName" : "Stickers & Tapes"
}, {
"categoryValueId" : "10508",
"categoryValueName" : "Textiel & Handwerken"
} ]
},
"filterRanges" : [ {
"rangeId" : "PRICE",
"rangeName" : "Prijs",
"min" : 0.99,
"max" : 4599,
"unit" : "EUR"
}, {
"rangeId" : "RATING",
"rangeName" : "Beoordeling",
"min" : 0,
"max" : 5,
"unit" : "sterren"
} ],
"filters" : [ {
"filterName" : "Meest populair bij",
"filterValues" : [ {
"filterValueId" : "8071",
"filterValueName" : "Volwassenen"
}, {
"filterValueId" : "8069",
"filterValueName" : "Jongens en meisjes"
} ]
}, {
"filterName" : "Leeftijd",
"filterValues" : [ {
"filterValueId" : "4268583885",
"filterValueName" : "13 jaar en ouder"
}, {
"filterValueId" : "4268583884",
"filterValueName" : "9-12 jaar"
} ]
} ]
}
Get list of product list filters for search term 'lego'
Get product list filters based on search term.
GET /retailer-demo/products/list-filters?country-code=BE&search-term=lego
-
Request
-
Response
Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)
Accept-Language: nl
This endpoint has no request body.
Content-Type: application/vnd.retailer.v10+json
Content-Language: nl
Status: 200 OK
{
"categoryData" : {
"categoryName" : "Categorieën",
"categoryValues" : [ {
"categoryValueId" : "7934",
"categoryValueName" : "Speelgoed"
}, {
"categoryValueId" : "8299",
"categoryValueName" : "Boeken"
} ]
},
"filterRanges" : [ {
"rangeId" : "PRICE",
"rangeName" : "Prijs",
"min" : 0.99,
"max" : 4599,
"unit" : "EUR"
}, {
"rangeId" : "RATING",
"rangeName" : "Beoordeling",
"min" : 0,
"max" : 5,
"unit" : "sterren"
} ],
"filters" : [ {
"filterName" : "Serie",
"filterValues" : [ {
"filterValueId" : "4279587082",
"filterValueName" : "LEGO Star Wars"
}, {
"filterValueId" : "4279587092",
"filterValueName" : "LEGO City"
} ]
}, {
"filterName" : "Leeftijd",
"filterValues" : [ {
"filterValueId" : "4268583884",
"filterValueName" : "9-12 jaar"
}, {
"filterValueId" : "4279522808",
"filterValueName" : "7-8 jaar"
} ]
} ]
}
Get product categories and URL in NL
Gets a list of categories the product belongs to, and the URL to its page in The Netherlands.
GET /retailer-demo/products/4042448804839/placement?country-code=NL
-
Request
-
Response
Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)
This endpoint has no request body.
Content-Type: application/vnd.retailer.v10+json
Status: 200 OK
{
"url" : "https://www.acc2.bol.com/nl/nl/p/tesa-afplakband-50m-x-19mm/9200000010397028/",
"categories" : [ {
"categoryId" : "13155",
"categoryName" : "Klussen",
"subcategories" : [ {
"id" : "13261",
"name" : "Verfspullen",
"subcategories" : [ {
"id" : "13263",
"name" : "Schilderspullen",
"subcategories" : [ {
"id" : "13265",
"name" : "Afplaktape"
} ]
} ]
} ]
} ]
}
Get product ratings by EAN
Get the product rating and the underlying rating counts for a specific EAN.
GET /retailer-demo/products/5030917181740/ratings
-
Request
-
Response
Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)
This endpoint has no request body.
Content-Type: application/vnd.retailer.v10+json
Status: 200 OK
{
"ratings" : [ {
"rating" : 5,
"count" : 488
}, {
"rating" : 4,
"count" : 66
}, {
"rating" : 3,
"count" : 12
}, {
"rating" : 2,
"count" : 0
}, {
"rating" : 1,
"count" : 11
} ]
}
Retrieve price star boundaries
Example request for retrieving price star boundaries.
GET /retailer-demo/products/8719743071568/price-star-boundaries
-
Request
-
Response
Accept: application/vnd.retailer.v10+json
Content-Type: None
Authorization: Bearer token (omitted)
This endpoint has no request body.
Content-Type: application/vnd.retailer.v10+json
Status: 200 OK
{
"lastModifiedDateTime" : "2022-01-07T03:18:38+01:00",
"priceStarBoundaryLevels" : [ {
"level" : 5,
"boundaryPrice" : 0.01
}, {
"level" : 4,
"boundaryPrice" : 41.0
}, {
"level" : 3,
"boundaryPrice" : 46.0
}, {
"level" : 2,
"boundaryPrice" : 50.0
} ]
}