Search shops

GET /shops/search

Request

Query string (URL)

Append the querystring with following properties to the URL.

A dictionary with fields

Field Type Description
query String Optional. A String value
coordinates Coordinates Optional. Coordinates of a place in the world
distance Int Optional. An integer value
sortBy String Optional. String. Should be equal to 'distance'
company_id Int Optional. Only return shops of this company ID

Example request 1

GET /shops/search?query=...&coordinates%5Blatitude%5D=1%2C54361&coordinates%5Blongitude%5D=0%2C45645&distance=17&sortBy=distance&company_id=14 HTTP/1.1
Host: api.bakeronline.be
X-VERSION: 1.3.0
Accept-Language: en-US,en;q=0.5

Response

Array of Shop.detailed: [Shop.detailed]

Shop.detailed

Field Type Description
id Int Id of the shop
name String Name of the shop (translated)
address Address.detailed An address
offers [Offer.simple] Array of Offer.simple
images [String: Image] Dictionary of Image with keys of type String
allow_comments Bool A boolean value
allow_orders Bool A boolean value
delivery_use_intervals Bool A boolean value
categories [Category.simple] Array of Category.simple
category_groups [CategoryGroup] List of category groups. The ids refer to a category in the categories field. Categories without a CategoryGroup should also get displayed.
currency Currency 3 letter ISO 4217 currency name (string)

Example response 1

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 24714

[
    {
        "id": 12,
        "name": "Roselyn Stroman II",
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE",
            "position": {
                "latitude": 1.54361,
                "longitude": 0.45645
            }
        },
        "offers": [
            {
                "id": 19,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 17,
                        "percentage": 10,
                        "minimum": 15
                    },
                    {
                        "type": "product",
                        "item_id": 12,
                        "percentage": 14,
                        "minimum": 19
                    },
                    {
                        "type": "product",
                        "item_id": 15,
                        "percentage": 12,
                        "minimum": 19
                    }
                ]
            },
            {
                "id": 11,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 15,
                        "percentage": 10,
                        "minimum": 16
                    },
                    {
                        "type": "product",
                        "item_id": 12,
                        "percentage": 18,
                        "minimum": 18
                    },
                    {
                        "type": "product",
                        "item_id": 17,
                        "percentage": 17,
                        "minimum": 15
                    }
                ]
            },
            {
                "id": 17,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 19,
                        "percentage": 13,
                        "minimum": 19
                    },
                    {
                        "type": "product",
                        "item_id": 17,
                        "percentage": 15,
                        "minimum": 15
                    },
                    {
                        "type": "product",
                        "item_id": 16,
                        "percentage": 13,
                        "minimum": 16
                    }
                ]
            }
        ],
        "images": {
            "avatar": {
                "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
            }
        },
        "allow_comments": true,
        "allow_orders": false,
        "delivery_use_intervals": true,
        "categories": [
            {
                "id": 13,
                "name": "Marquis Kuhn IV",
                "banner": {
                    "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
                },
                "seo": {
                    "title": {
                        "en": "Aut voluptate ipsa ad et vero et nisi itaque quas et."
                    },
                    "description": {
                        "en": "Beatae debitis rerum consequatur. Non nihil saepe quasi. Qui quis error voluptas consectetur."
                    },
                    "url": {
                        "en": "http://www.herman.org/aut-corporis-maiores-iste-ab-est.html"
                    }
                }
            },
            {
                "id": 17,
                "name": "Stacy Ernser",
                "banner": {
                    "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
                },
                "seo": {
                    "title": {
                        "en": "In quo aut et et provident consectetur laudantium."
                    },
                    "description": {
                        "en": "Tenetur eius natus accusamus libero. Aperiam voluptas sit saepe vero."
                    },
                    "url": {
                        "en": "http://www.berge.com/"
                    }
                }
            },
            {
                "id": 12,
                "name": "Kira Boyer",
                "banner": {
                    "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
                },
                "seo": {
                    "title": {
                        "en": "Iusto dolorum consequatur quam velit velit repellendus provident eveniet rerum."
                    },
                    "description": {
                        "en": "Maiores enim quidem nihil quis odio doloribus sapiente. Quod omnis vel enim temporibus accusamus sit. Et omnis autem quia voluptas sed eum maxime."
                    },
                    "url": {
                        "en": "http://harvey.com/"
                    }
                }
            }
        ],
        "category_groups": [
            {
                "name": "...",
                "category_ids": [
                    10,
                    18,
                    19
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    15,
                    18,
                    16
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    15,
                    17,
                    16
                ]
            }
        ],
        "currency": "EUR"
    },
    {
        "id": 14,
        "name": "Roslyn Lakin",
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE",
            "position": {
                "latitude": 1.54361,
                "longitude": 0.45645
            }
        },
        "offers": [
            {
                "id": 17,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 13,
                        "percentage": 17,
                        "minimum": 13
                    },
                    {
                        "type": "product",
                        "item_id": 11,
                        "percentage": 17,
                        "minimum": 12
                    },
                    {
                        "type": "product",
                        "item_id": 16,
                        "percentage": 17,
                        "minimum": 18
                    }
                ]
            },
            {
                "id": 14,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 13,
                        "percentage": 16,
                        "minimum": 12
                    },
                    {
                        "type": "product",
                        "item_id": 13,
                        "percentage": 18,
                        "minimum": 10
                    },
                    {
                        "type": "product",
                        "item_id": 17,
                        "percentage": 14,
                        "minimum": 14
                    }
                ]
            },
            {
                "id": 16,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 13,
                        "percentage": 10,
                        "minimum": 17
                    },
                    {
                        "type": "product",
                        "item_id": 11,
                        "percentage": 10,
                        "minimum": 14
                    },
                    {
                        "type": "product",
                        "item_id": 19,
                        "percentage": 15,
                        "minimum": 15
                    }
                ]
            }
        ],
        "images": {
            "avatar": {
                "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
            }
        },
        "allow_comments": true,
        "allow_orders": false,
        "delivery_use_intervals": false,
        "categories": [
            {
                "id": 15,
                "name": "Alverta McLaughlin PhD",
                "banner": {
                    "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
                },
                "seo": {
                    "title": {
                        "en": "Et asperiores expedita velit doloribus in qui sunt voluptas rerum odit."
                    },
                    "description": {
                        "en": "Vero fuga ut consequuntur itaque dolorem. Praesentium vero vitae tempore consequatur omnis. Ex atque sint possimus."
                    },
                    "url": {
                        "en": "http://satterfield.org/consectetur-vitae-doloremque-non"
                    }
                }
            },
            {
                "id": 15,
                "name": "Toby Stoltenberg",
                "banner": {
                    "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
                },
                "seo": {
                    "title": {
                        "en": "Asperiores est laboriosam ducimus in fuga porro consectetur laborum laborum."
                    },
                    "description": {
                        "en": "Sint magni aperiam a doloribus sunt velit. Cumque et ipsa molestiae quod id. Voluptatem officia natus aut. Consectetur molestiae quod dolor non sapiente."
                    },
                    "url": {
                        "en": "http://www.bode.biz/facilis-ratione-eum-commodi-et"
                    }
                }
            },
            {
                "id": 12,
                "name": "Triston Herman",
                "banner": {
                    "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
                },
                "seo": {
                    "title": {
                        "en": "Repudiandae voluptatum et ut culpa officia illum ut mollitia omnis."
                    },
                    "description": {
                        "en": "Molestias necessitatibus nisi sunt. Voluptate nihil ea laudantium."
                    },
                    "url": {
                        "en": "http://hamill.info/quo-maxime-eum-consequuntur-molestiae-nesciunt"
                    }
                }
            }
        ],
        "category_groups": [
            {
                "name": "...",
                "category_ids": [
                    13,
                    14,
                    11
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    10,
                    13,
                    14
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    16,
                    11,
                    17
                ]
            }
        ],
        "currency": "EUR"
    },
    {
        "id": 14,
        "name": "Prof. Ewald Pfeffer IV",
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE",
            "position": {
                "latitude": 1.54361,
                "longitude": 0.45645
            }
        },
        "offers": [
            {
                "id": 12,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 14,
                        "percentage": 17,
                        "minimum": 17
                    },
                    {
                        "type": "product",
                        "item_id": 10,
                        "percentage": 19,
                        "minimum": 10
                    },
                    {
                        "type": "product",
                        "item_id": 16,
                        "percentage": 15,
                        "minimum": 11
                    }
                ]
            },
            {
                "id": 13,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 19,
                        "percentage": 19,
                        "minimum": 15
                    },
                    {
                        "type": "product",
                        "item_id": 13,
                        "percentage": 16,
                        "minimum": 12
                    },
                    {
                        "type": "product",
                        "item_id": 16,
                        "percentage": 10,
                        "minimum": 18
                    }
                ]
            },
            {
                "id": 18,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 10,
                        "percentage": 12,
                        "minimum": 19
                    },
                    {
                        "type": "product",
                        "item_id": 16,
                        "percentage": 10,
                        "minimum": 14
                    },
                    {
                        "type": "product",
                        "item_id": 13,
                        "percentage": 15,
                        "minimum": 19
                    }
                ]
            }
        ],
        "images": {
            "avatar": {
                "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
            }
        },
        "allow_comments": true,
        "allow_orders": true,
        "delivery_use_intervals": true,
        "categories": [
            {
                "id": 14,
                "name": "Aylin Schoen IV",
                "banner": {
                    "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
                },
                "seo": {
                    "title": {
                        "en": "Velit amet labore animi et optio quia id qui nobis earum similique."
                    },
                    "description": {
                        "en": "Tenetur quas facere sit itaque nemo velit ab porro. Nobis vel voluptates fuga quaerat. Aut perspiciatis est nobis enim voluptatem natus. Est quibusdam illo dignissimos aut."
                    },
                    "url": {
                        "en": "https://www.hahn.org/eaque-quo-quos-cupiditate-exercitationem-quod-consequatur"
                    }
                }
            },
            {
                "id": 11,
                "name": "Prof. Magali Luettgen",
                "banner": {
                    "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
                },
                "seo": {
                    "title": {
                        "en": "Id et ut corrupti placeat earum."
                    },
                    "description": {
                        "en": "Tempora repudiandae quisquam quo et et. Minima voluptatibus illum vero consectetur excepturi earum voluptate. Libero molestiae atque aut dolor vel. Neque modi excepturi non."
                    },
                    "url": {
                        "en": "http://ernser.com/odit-autem-voluptatem-consequuntur-eos-eos-rerum-molestiae.html"
                    }
                }
            },
            {
                "id": 15,
                "name": "Ms. Cheyenne Runte I",
                "banner": {
                    "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
                },
                "seo": {
                    "title": {
                        "en": "Corporis est sit vitae explicabo consequatur quasi molestiae reiciendis quia iure."
                    },
                    "description": {
                        "en": "Voluptas eum omnis placeat ut qui nisi. Sed vero dolorem explicabo voluptas animi earum sed. Quia et optio consequatur odio."
                    },
                    "url": {
                        "en": "http://www.bechtelar.biz/distinctio-eum-odio-non-ad"
                    }
                }
            }
        ],
        "category_groups": [
            {
                "name": "...",
                "category_ids": [
                    17,
                    10,
                    12
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    19,
                    16,
                    11
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    12,
                    11,
                    17
                ]
            }
        ],
        "currency": "EUR"
    }
]
Version update available Please adjust your integration to the latest stable version (1.9.0)
1.3.0 stable