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
  } ]
}