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'

Example request 1

GET /shops/search?query=...&coordinates%5Blatitude%5D=1%2C54361&coordinates%5Blongitude%5D=0%2C45645&distance=16&sortBy=distance HTTP/1.1
Host: api.bakeronline.be
X-VERSION: 0.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.

Example response 1

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

[
    {
        "id": 14,
        "name": "Priscilla Funk",
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE",
            "position": {
                "latitude": 1.54361,
                "longitude": 0.45645
            }
        },
        "offers": [
            {
                "id": 13,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 15,
                        "percentage": 14,
                        "minimum": 17
                    },
                    {
                        "type": "product",
                        "item_id": 10,
                        "percentage": 18,
                        "minimum": 15
                    },
                    {
                        "type": "product",
                        "item_id": 16,
                        "percentage": 10,
                        "minimum": 12
                    }
                ]
            },
            {
                "id": 15,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 19,
                        "percentage": 14,
                        "minimum": 13
                    },
                    {
                        "type": "product",
                        "item_id": 14,
                        "percentage": 12,
                        "minimum": 11
                    },
                    {
                        "type": "product",
                        "item_id": 12,
                        "percentage": 11,
                        "minimum": 16
                    }
                ]
            },
            {
                "id": 10,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 19,
                        "percentage": 16,
                        "minimum": 11
                    },
                    {
                        "type": "product",
                        "item_id": 14,
                        "percentage": 10,
                        "minimum": 12
                    },
                    {
                        "type": "product",
                        "item_id": 18,
                        "percentage": 19,
                        "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": false
            }
        },
        "allow_comments": true,
        "allow_orders": true,
        "delivery_use_intervals": true,
        "categories": [
            {
                "id": 14,
                "name": "Jess Bins",
                "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": "Est quam aliquam cupiditate modi laudantium ipsa sed."
                    },
                    "description": {
                        "en": "Ipsa qui consequatur autem. Unde illum ipsum consequuntur id corporis cupiditate. Dolor id quod quam sint ut et."
                    },
                    "url": {
                        "en": "https://dickinson.com/qui-quos-accusamus-quis-autem-sit-ex-ut.html"
                    }
                }
            },
            {
                "id": 11,
                "name": "Mrs. Aaliyah Bernhard 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": "Ratione tempora quae quaerat ab rem delectus asperiores deleniti aperiam."
                    },
                    "description": {
                        "en": "Voluptatem enim eum ut labore. Repudiandae sequi corrupti eius ipsum modi. Cumque itaque aspernatur dolorem at autem."
                    },
                    "url": {
                        "en": "http://www.heller.org/"
                    }
                }
            },
            {
                "id": 19,
                "name": "Frieda Haley",
                "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": "Qui laborum id facilis quidem qui ea quo debitis ut omnis."
                    },
                    "description": {
                        "en": "Perspiciatis ipsam quo molestiae non. In officiis qui est. Minus sit odit nisi repellat non veritatis similique. Quae accusamus quam maxime ab magnam corrupti."
                    },
                    "url": {
                        "en": "http://dicki.com/deserunt-adipisci-aliquid-beatae-quis-consequatur"
                    }
                }
            }
        ],
        "category_groups": [
            {
                "name": "...",
                "category_ids": [
                    18,
                    11,
                    15
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    13,
                    13,
                    15
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    10,
                    14,
                    14
                ]
            }
        ]
    },
    {
        "id": 19,
        "name": "Maximo Welch",
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE",
            "position": {
                "latitude": 1.54361,
                "longitude": 0.45645
            }
        },
        "offers": [
            {
                "id": 11,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 12,
                        "percentage": 16,
                        "minimum": 18
                    },
                    {
                        "type": "product",
                        "item_id": 10,
                        "percentage": 18,
                        "minimum": 19
                    },
                    {
                        "type": "product",
                        "item_id": 18,
                        "percentage": 14,
                        "minimum": 11
                    }
                ]
            },
            {
                "id": 19,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 16,
                        "percentage": 18,
                        "minimum": 16
                    },
                    {
                        "type": "product",
                        "item_id": 18,
                        "percentage": 13,
                        "minimum": 14
                    },
                    {
                        "type": "product",
                        "item_id": 19,
                        "percentage": 15,
                        "minimum": 18
                    }
                ]
            },
            {
                "id": 17,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 14,
                        "percentage": 16,
                        "minimum": 19
                    },
                    {
                        "type": "product",
                        "item_id": 10,
                        "percentage": 17,
                        "minimum": 18
                    },
                    {
                        "type": "product",
                        "item_id": 12,
                        "percentage": 13,
                        "minimum": 13
                    }
                ]
            }
        ],
        "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": false,
        "categories": [
            {
                "id": 11,
                "name": "Ashlee Nader",
                "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": "Amet consequatur ut sapiente voluptatum error nihil ipsum in."
                    },
                    "description": {
                        "en": "Nihil vitae maiores esse dicta. Cumque vel odit eum. Veniam veritatis dolorum alias sint soluta quod."
                    },
                    "url": {
                        "en": "http://www.wilkinson.info/odio-aliquam-beatae-repellendus"
                    }
                }
            },
            {
                "id": 10,
                "name": "Magnolia Hermiston",
                "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": "Incidunt numquam tempora inventore aut suscipit ducimus sit dolores sed."
                    },
                    "description": {
                        "en": "Atque mollitia voluptatem est rerum aliquid quis quaerat. Est dolorem itaque voluptas officia odit. Eveniet et doloremque libero reiciendis expedita officiis possimus."
                    },
                    "url": {
                        "en": "http://bernhard.com/at-sunt-et-officia-et-dolores-id-adipisci"
                    }
                }
            },
            {
                "id": 13,
                "name": "Vita Jones",
                "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": "Rerum tempore quia tenetur asperiores necessitatibus."
                    },
                    "description": {
                        "en": "Suscipit nulla debitis inventore molestiae qui. Architecto dolore aut odit ut numquam totam. Cumque dolorum et hic neque est. Aut dolores nesciunt facilis sit. Earum quia doloremque dolorum eveniet."
                    },
                    "url": {
                        "en": "http://feest.org/"
                    }
                }
            }
        ],
        "category_groups": [
            {
                "name": "...",
                "category_ids": [
                    17,
                    10,
                    18
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    14,
                    19,
                    14
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    15,
                    13,
                    18
                ]
            }
        ]
    },
    {
        "id": 12,
        "name": "Leonor Herzog",
        "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": 10,
                        "percentage": 16,
                        "minimum": 14
                    },
                    {
                        "type": "product",
                        "item_id": 10,
                        "percentage": 11,
                        "minimum": 19
                    },
                    {
                        "type": "product",
                        "item_id": 18,
                        "percentage": 15,
                        "minimum": 12
                    }
                ]
            },
            {
                "id": 19,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 17,
                        "percentage": 18,
                        "minimum": 18
                    },
                    {
                        "type": "product",
                        "item_id": 19,
                        "percentage": 13,
                        "minimum": 16
                    },
                    {
                        "type": "product",
                        "item_id": 12,
                        "percentage": 10,
                        "minimum": 10
                    }
                ]
            },
            {
                "id": 12,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 10,
                        "percentage": 11,
                        "minimum": 14
                    },
                    {
                        "type": "product",
                        "item_id": 12,
                        "percentage": 12,
                        "minimum": 19
                    },
                    {
                        "type": "product",
                        "item_id": 12,
                        "percentage": 15,
                        "minimum": 12
                    }
                ]
            }
        ],
        "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": false,
        "allow_orders": true,
        "delivery_use_intervals": false,
        "categories": [
            {
                "id": 10,
                "name": "Stephany Gutmann",
                "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": "Autem quisquam explicabo nam aut quas maiores sint maiores praesentium praesentium."
                    },
                    "description": {
                        "en": "Eum aut consectetur voluptas quia consequatur. Reiciendis neque a aliquam officiis non accusamus. Odio ducimus ut quia est."
                    },
                    "url": {
                        "en": "http://tromp.org/"
                    }
                }
            },
            {
                "id": 17,
                "name": "Gaetano Dickens",
                "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": "Aspernatur optio aut similique consequuntur dolorem ut consequatur ut velit ipsa."
                    },
                    "description": {
                        "en": "Vel vitae et labore iste dolores et saepe earum. Quo et in veritatis magni quis dolor eaque. Sint aut aliquid doloremque."
                    },
                    "url": {
                        "en": "http://www.hayes.com/"
                    }
                }
            },
            {
                "id": 16,
                "name": "Thomas West",
                "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": "Harum aliquam autem voluptatem eveniet reprehenderit dolor quia sunt totam omnis."
                    },
                    "description": {
                        "en": "Ipsa similique exercitationem doloribus ut. Et voluptatum ipsum tenetur eligendi. Commodi qui voluptatibus dolorem assumenda nam aut vel. Sint fuga exercitationem et."
                    },
                    "url": {
                        "en": "http://www.flatley.org/ea-nam-cumque-ea-sint"
                    }
                }
            }
        ],
        "category_groups": [
            {
                "name": "...",
                "category_ids": [
                    15,
                    13,
                    18
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    10,
                    16,
                    17
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    19,
                    16,
                    10
                ]
            }
        ]
    }
]
Version update available Please adjust your integration to the latest stable version (1.9.0)
0.3.0 stable