Properties
| Name | Type | Description |
|---|---|---|
| countryCode | stringnull | The country for which the products will be retrieved. |
| searchTerm | stringnull | The search term to get the associated products for. |
| categoryId | stringnull | The category to get the associated products for. |
| filterRanges | arraynull | The list of range filters to get associated products for. |
| filterValues | arraynull | The list of filter values in this filter. |
| sort | stringnull | Determines the order of the products. |
| page | integer | The requested page number with a page size of 50 items. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/bol-com/json-schema/bol-com-product-list-request-schema.json",
"title": "ProductListRequest",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/bol-com-products-api-openapi.yml#/components/schemas/ProductListRequest",
"type": "object",
"properties": {
"countryCode": {
"type": [
"string",
"null"
],
"description": "The country for which the products will be retrieved.",
"default": "NL",
"enum": [
"NL",
"BE",
null
]
},
"searchTerm": {
"maxLength": 50,
"minLength": 1,
"type": [
"string",
"null"
],
"description": "The search term to get the associated products for."
},
"categoryId": {
"maxLength": 11,
"minLength": 1,
"type": [
"string",
"null"
],
"description": "The category to get the associated products for."
},
"filterRanges": {
"maxItems": 10,
"minItems": 0,
"type": [
"array",
"null"
],
"description": "The list of range filters to get associated products for.",
"items": {
"$ref": "#/$defs/ProductListFilterRange"
}
},
"filterValues": {
"maxItems": 10,
"minItems": 0,
"type": [
"array",
"null"
],
"description": "The list of filter values in this filter.",
"items": {
"$ref": "#/$defs/ProductListFilterValue"
}
},
"sort": {
"type": [
"string",
"null"
],
"description": "Determines the order of the products.",
"enum": [
"RELEVANCE",
"POPULARITY",
"PRICE_ASC",
"PRICE_DESC",
"RELEASE_DATE",
"RATING",
"WISHLIST",
null
]
},
"page": {
"maximum": 200,
"minimum": 1,
"type": "integer",
"description": "The requested page number with a page size of 50 items.",
"format": "int32",
"default": 1
}
},
"$defs": {
"ProductListFilterRange": {
"required": [
"max",
"min",
"rangeId"
],
"type": "object",
"properties": {
"rangeId": {
"maxLength": 11,
"minLength": 1,
"type": "string",
"description": "The id of the range filter the products can be found within."
},
"min": {
"type": "number",
"description": "The minimum value for the range that can be used to filter the products."
},
"max": {
"type": "number",
"description": "The maximum value for the range that can be used to filter the products."
}
},
"description": "The list of range filters to get associated products for."
},
"ProductListFilterValue": {
"required": [
"filterValueId"
],
"type": "object",
"properties": {
"filterValueId": {
"type": "string",
"description": "The unique identifier of the filter value."
}
},
"description": "The list of filter values in this filter."
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/bol-com-product-list-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.