GET /shops/@shop/products/search
You can use authentication for this request, but it is not required. Always provide the access_token when you have one. It may affect the response.
Header | Value |
---|---|
Authorization | Optional. Set the value to Bearer + + access_token |
Replace the @ keywords in the URL with their corresponding value.
A dictionary with fields
Field | Type | Description |
---|---|---|
shop | Int | An integer value |
Append the querystring with following properties to the URL.
A dictionary with fields
Field | Type | Description |
---|---|---|
query | String | A String value |
GET /shops/17/products/search?query=... HTTP/1.1
Host: api.bakeronline.be
X-VERSION: 1.5.1
Accept-Language: en-US,en;q=0.5
Array of Product.detailed: [Product.detailed]
Field | Type | Description |
---|---|---|
id | Int | Id of the product |
name | String | Name of the product (translated) |
images | [Image] | Array of Image |
price_type | PriceType | A product has a price type that defines the price calculations and the way consumers can order the product. |
target_price | Bool | Is true when the price of the product can change on takeout (e.g. not exact weight) |
price | Price | Price of the product (cents). It only makes sense to use this property when price_type is not multiple choice. Please also check if the shop where you want to order has an offer with a discount for this product available. |
subtitle | String? | Nullable. Important text you need to display under the product name |
description | String | Description of the product (translated) |
allergens | [Allergen]? | Nullable. The allergens of this product. An empty array means no allergens. Null means no allergens specified (= can have allergens, ask in shop) |
url | URL? | Nullable. An URL field starting with http:// or https:// |
url_type | String | String enumarion of 'none', 'recipe', 'website' |
specialty | Bool | A boolean value |
favourite | Bool? | Nullable. A boolean value |
product_prices | [ProductPrice.detailed] | Array of ProductPrice.detailed |
optionsets | [OptionSet.detailed] | Array of OptionSet.detailed |
min_max | MinMaxSummary | An overview of the minimum and maximum values for all amount types. |
info | [Message] | A list of messages with information you need to display on the product page. |
offer | OfferItem.detailed? | Nullable. Specificies where a discount should get appllied. A shop can give a complete category a discount, or only a certain product, or only a fixed product price. When calculating the discount, always round the price to 1 cent before multiplying it with an amount, persons or kilograms. |
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 52066
[
{
"id": 16,
"name": "...",
"images": [
{
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
{
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
{
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
}
],
"price_type": "PER_UNIT",
"target_price": false,
"price": {
"value": 16,
"currency": "EUR"
},
"subtitle": "...",
"description": "...",
"allergens": [
{
"id": 18,
"name": "Lupine"
},
{
"id": 13,
"name": "Crustaceans"
},
{
"id": 11,
"name": "Lupine"
}
],
"url": "https://example.com",
"url_type": "none",
"specialty": true,
"favourite": false,
"product_prices": [
{
"id": 12,
"name": "...",
"price": {
"value": 14,
"currency": "EUR"
},
"offer": {
"type": "percentage",
"x": 16,
"y": 10,
"percentage": 14,
"minimum": 15,
"offer": {
"id": 13,
"name": "Black Friday"
}
}
},
{
"id": 13,
"name": "...",
"price": {
"value": 18,
"currency": "EUR"
},
"offer": {
"type": "percentage",
"x": 12,
"y": 11,
"percentage": 10,
"minimum": 13,
"offer": {
"id": 19,
"name": "Black Friday"
}
}
},
{
"id": 10,
"name": "...",
"price": {
"value": 14,
"currency": "EUR"
},
"offer": {
"type": "percentage",
"x": 17,
"y": 11,
"percentage": 10,
"minimum": 14,
"offer": {
"id": 19,
"name": "Black Friday"
}
}
}
],
"optionsets": [
{
"id": 17,
"name": "...",
"code": "...",
"options": [
{
"id": 14,
"name": "...",
"price_change": {
"value": 12,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
"require_image": true,
"code": "..."
},
{
"id": 13,
"name": "...",
"price_change": {
"value": 12,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
"require_image": false,
"code": "..."
},
{
"id": 11,
"name": "...",
"price_change": {
"value": 12,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": false,
"code": "..."
}
]
},
{
"id": 16,
"name": "...",
"code": "...",
"options": [
{
"id": 10,
"name": "...",
"price_change": {
"value": 13,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
"require_image": false,
"code": "..."
},
{
"id": 15,
"name": "...",
"price_change": {
"value": 12,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
"require_image": true,
"code": "..."
},
{
"id": 17,
"name": "...",
"price_change": {
"value": 18,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": false,
"code": "..."
}
]
},
{
"id": 18,
"name": "...",
"code": "...",
"options": [
{
"id": 16,
"name": "...",
"price_change": {
"value": 10,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
"require_image": true,
"code": "..."
},
{
"id": 10,
"name": "...",
"price_change": {
"value": 10,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": true,
"code": "..."
},
{
"id": 10,
"name": "...",
"price_change": {
"value": 13,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
"require_image": true,
"code": "..."
}
]
}
],
"min_max": {
"amount": {
"minimum": 16,
"maximum": 12,
"suggested": 19
},
"weight": {
"minimum": 13,
"maximum": 12,
"suggested": 10
},
"persons": {
"minimum": 19,
"maximum": 19,
"suggested": 16
}
},
"info": [
{
"name": "...",
"title": "...",
"text": "...",
"type": "HTML"
},
{
"name": "...",
"title": "...",
"text": "...",
"type": "HTML"
},
{
"name": "...",
"title": "...",
"text": "...",
"type": "HTML"
}
],
"offer": {
"type": "percentage",
"x": 15,
"y": 15,
"percentage": 19,
"minimum": 15,
"offer": {
"id": 11,
"name": "Black Friday"
}
}
},
{
"id": 10,
"name": "...",
"images": [
{
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
{
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
{
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
}
],
"price_type": "PER_UNIT",
"target_price": false,
"price": {
"value": 14,
"currency": "EUR"
},
"subtitle": "...",
"description": "...",
"allergens": [
{
"id": 11,
"name": "Mustard"
},
{
"id": 18,
"name": "Nuts"
},
{
"id": 15,
"name": "Nuts"
}
],
"url": "https://example.com",
"url_type": "none",
"specialty": false,
"favourite": false,
"product_prices": [
{
"id": 15,
"name": "...",
"price": {
"value": 14,
"currency": "EUR"
},
"offer": {
"type": "percentage",
"x": 14,
"y": 12,
"percentage": 13,
"minimum": 14,
"offer": {
"id": 16,
"name": "Black Friday"
}
}
},
{
"id": 17,
"name": "...",
"price": {
"value": 14,
"currency": "EUR"
},
"offer": {
"type": "percentage",
"x": 10,
"y": 19,
"percentage": 17,
"minimum": 10,
"offer": {
"id": 10,
"name": "Black Friday"
}
}
},
{
"id": 15,
"name": "...",
"price": {
"value": 16,
"currency": "EUR"
},
"offer": {
"type": "percentage",
"x": 13,
"y": 13,
"percentage": 17,
"minimum": 19,
"offer": {
"id": 11,
"name": "Black Friday"
}
}
}
],
"optionsets": [
{
"id": 15,
"name": "...",
"code": "...",
"options": [
{
"id": 16,
"name": "...",
"price_change": {
"value": 12,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": true,
"code": "..."
},
{
"id": 13,
"name": "...",
"price_change": {
"value": 12,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": true,
"code": "..."
},
{
"id": 14,
"name": "...",
"price_change": {
"value": 18,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
"require_image": false,
"code": "..."
}
]
},
{
"id": 19,
"name": "...",
"code": "...",
"options": [
{
"id": 12,
"name": "...",
"price_change": {
"value": 12,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
"require_image": false,
"code": "..."
},
{
"id": 19,
"name": "...",
"price_change": {
"value": 16,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": false,
"code": "..."
},
{
"id": 13,
"name": "...",
"price_change": {
"value": 14,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
"require_image": false,
"code": "..."
}
]
},
{
"id": 17,
"name": "...",
"code": "...",
"options": [
{
"id": 15,
"name": "...",
"price_change": {
"value": 11,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": true,
"code": "..."
},
{
"id": 11,
"name": "...",
"price_change": {
"value": 15,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": true,
"code": "..."
},
{
"id": 13,
"name": "...",
"price_change": {
"value": 13,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": false,
"code": "..."
}
]
}
],
"min_max": {
"amount": {
"minimum": 13,
"maximum": 11,
"suggested": 13
},
"weight": {
"minimum": 19,
"maximum": 19,
"suggested": 10
},
"persons": {
"minimum": 11,
"maximum": 19,
"suggested": 10
}
},
"info": [
{
"name": "...",
"title": "...",
"text": "...",
"type": "HTML"
},
{
"name": "...",
"title": "...",
"text": "...",
"type": "HTML"
},
{
"name": "...",
"title": "...",
"text": "...",
"type": "HTML"
}
],
"offer": {
"type": "percentage",
"x": 18,
"y": 11,
"percentage": 11,
"minimum": 15,
"offer": {
"id": 16,
"name": "Black Friday"
}
}
},
{
"id": 14,
"name": "...",
"images": [
{
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
{
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
{
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
}
],
"price_type": "PER_UNIT",
"target_price": true,
"price": {
"value": 17,
"currency": "EUR"
},
"subtitle": "...",
"description": "...",
"allergens": [
{
"id": 12,
"name": "Mustard"
},
{
"id": 15,
"name": "Milk"
},
{
"id": 15,
"name": "Peanut"
}
],
"url": "https://example.com",
"url_type": "none",
"specialty": true,
"favourite": false,
"product_prices": [
{
"id": 13,
"name": "...",
"price": {
"value": 14,
"currency": "EUR"
},
"offer": {
"type": "percentage",
"x": 12,
"y": 10,
"percentage": 19,
"minimum": 17,
"offer": {
"id": 15,
"name": "Black Friday"
}
}
},
{
"id": 17,
"name": "...",
"price": {
"value": 12,
"currency": "EUR"
},
"offer": {
"type": "percentage",
"x": 11,
"y": 17,
"percentage": 16,
"minimum": 12,
"offer": {
"id": 11,
"name": "Black Friday"
}
}
},
{
"id": 17,
"name": "...",
"price": {
"value": 19,
"currency": "EUR"
},
"offer": {
"type": "percentage",
"x": 17,
"y": 16,
"percentage": 17,
"minimum": 16,
"offer": {
"id": 15,
"name": "Black Friday"
}
}
}
],
"optionsets": [
{
"id": 11,
"name": "...",
"code": "...",
"options": [
{
"id": 17,
"name": "...",
"price_change": {
"value": 14,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
"require_image": false,
"code": "..."
},
{
"id": 10,
"name": "...",
"price_change": {
"value": 12,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": false,
"code": "..."
},
{
"id": 10,
"name": "...",
"price_change": {
"value": 13,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": true,
"code": "..."
}
]
},
{
"id": 13,
"name": "...",
"code": "...",
"options": [
{
"id": 12,
"name": "...",
"price_change": {
"value": 11,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
"require_image": true,
"code": "..."
},
{
"id": 18,
"name": "...",
"price_change": {
"value": 11,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": false,
"code": "..."
},
{
"id": 19,
"name": "...",
"price_change": {
"value": 19,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": true,
"code": "..."
}
]
},
{
"id": 12,
"name": "...",
"code": "...",
"options": [
{
"id": 19,
"name": "...",
"price_change": {
"value": 18,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": true,
"code": "..."
},
{
"id": 18,
"name": "...",
"price_change": {
"value": 13,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": true
},
"require_image": false,
"code": "..."
},
{
"id": 15,
"name": "...",
"price_change": {
"value": 13,
"currency": "EUR"
},
"image": {
"resolutions": [
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
},
{
"src": "https://example.com",
"width": 600,
"height": 350
}
],
"white_background": false
},
"require_image": false,
"code": "..."
}
]
}
],
"min_max": {
"amount": {
"minimum": 11,
"maximum": 13,
"suggested": 17
},
"weight": {
"minimum": 13,
"maximum": 18,
"suggested": 15
},
"persons": {
"minimum": 15,
"maximum": 10,
"suggested": 13
}
},
"info": [
{
"name": "...",
"title": "...",
"text": "...",
"type": "HTML"
},
{
"name": "...",
"title": "...",
"text": "...",
"type": "HTML"
},
{
"name": "...",
"title": "...",
"text": "...",
"type": "HTML"
}
],
"offer": {
"type": "percentage",
"x": 14,
"y": 10,
"percentage": 14,
"minimum": 14,
"offer": {
"id": 15,
"name": "Black Friday"
}
}
}
]