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=11&sortBy=distance HTTP/1.1
Host: api.bakeronline.be
X-VERSION: 0.2.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: 24431

[
    {
        "id": 17,
        "name": "Tavares Schmidt",
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE",
            "position": {
                "latitude": 1.54361,
                "longitude": 0.45645
            }
        },
        "offers": [
            {
                "id": 14,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 13,
                        "percentage": 15,
                        "minimum": 15
                    },
                    {
                        "type": "product",
                        "item_id": 16,
                        "percentage": 11,
                        "minimum": 13
                    },
                    {
                        "type": "product",
                        "item_id": 11,
                        "percentage": 17,
                        "minimum": 13
                    }
                ]
            },
            {
                "id": 13,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 19,
                        "percentage": 13,
                        "minimum": 14
                    },
                    {
                        "type": "product",
                        "item_id": 10,
                        "percentage": 16,
                        "minimum": 12
                    },
                    {
                        "type": "product",
                        "item_id": 19,
                        "percentage": 14,
                        "minimum": 11
                    }
                ]
            },
            {
                "id": 13,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 19,
                        "percentage": 19,
                        "minimum": 17
                    },
                    {
                        "type": "product",
                        "item_id": 18,
                        "percentage": 13,
                        "minimum": 19
                    },
                    {
                        "type": "product",
                        "item_id": 16,
                        "percentage": 16,
                        "minimum": 18
                    }
                ]
            }
        ],
        "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": true,
        "categories": [
            {
                "id": 19,
                "name": "Marley Schuppe",
                "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": "Qui ex voluptatibus est sunt et aut non."
                    },
                    "description": {
                        "en": "Itaque quisquam illo officia ipsum commodi eius aut. Quae aut magni voluptatem provident occaecati minima et cupiditate."
                    },
                    "url": {
                        "en": "http://baumbach.com/"
                    }
                }
            },
            {
                "id": 14,
                "name": "Colin Toy",
                "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 ullam rerum rerum consequatur similique dolores aperiam officia."
                    },
                    "description": {
                        "en": "Nostrum quia laborum officiis voluptatum veniam autem autem. Et dolores quam eos assumenda. Dolores eos et dolor neque. Amet qui at voluptatem beatae error consequatur."
                    },
                    "url": {
                        "en": "https://littel.com/modi-eveniet-vero-dolor-exercitationem.html"
                    }
                }
            },
            {
                "id": 11,
                "name": "Prof. Keaton Wehner DVM",
                "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": "Quia hic sed consectetur et nam repellendus quis."
                    },
                    "description": {
                        "en": "Quia reiciendis ea aut nemo debitis. Delectus eos qui libero optio cumque. Aut quasi consequatur in voluptatem."
                    },
                    "url": {
                        "en": "http://www.armstrong.biz/consequatur-veritatis-dolores-nesciunt.html"
                    }
                }
            }
        ],
        "category_groups": [
            {
                "name": "...",
                "category_ids": [
                    14,
                    18,
                    16
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    11,
                    17,
                    12
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    12,
                    15,
                    19
                ]
            }
        ]
    },
    {
        "id": 16,
        "name": "Prof. Trisha Hill",
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE",
            "position": {
                "latitude": 1.54361,
                "longitude": 0.45645
            }
        },
        "offers": [
            {
                "id": 10,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 18,
                        "percentage": 17,
                        "minimum": 13
                    },
                    {
                        "type": "product",
                        "item_id": 17,
                        "percentage": 10,
                        "minimum": 11
                    },
                    {
                        "type": "product",
                        "item_id": 16,
                        "percentage": 12,
                        "minimum": 19
                    }
                ]
            },
            {
                "id": 12,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 13,
                        "percentage": 19,
                        "minimum": 12
                    },
                    {
                        "type": "product",
                        "item_id": 11,
                        "percentage": 13,
                        "minimum": 14
                    },
                    {
                        "type": "product",
                        "item_id": 11,
                        "percentage": 18,
                        "minimum": 14
                    }
                ]
            },
            {
                "id": 14,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 19,
                        "percentage": 18,
                        "minimum": 10
                    },
                    {
                        "type": "product",
                        "item_id": 13,
                        "percentage": 12,
                        "minimum": 16
                    },
                    {
                        "type": "product",
                        "item_id": 18,
                        "percentage": 10,
                        "minimum": 11
                    }
                ]
            }
        ],
        "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": false,
        "categories": [
            {
                "id": 10,
                "name": "Gennaro Torp",
                "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 id ea libero aspernatur nobis ex omnis unde ex eos."
                    },
                    "description": {
                        "en": "Error et eveniet molestias dolorem et qui. Doloremque rerum eos perferendis ipsam ea non corrupti."
                    },
                    "url": {
                        "en": "https://sawayn.org/sit-accusamus-reiciendis-officiis-culpa.html"
                    }
                }
            },
            {
                "id": 19,
                "name": "Madonna Mueller",
                "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": "Nesciunt voluptas dolores autem facere reiciendis."
                    },
                    "description": {
                        "en": "Maiores reiciendis quia in fugiat sint. Quam omnis omnis praesentium quo. Odio et in laborum qui repellat ut officiis. Natus rem eaque nobis quod aut vitae."
                    },
                    "url": {
                        "en": "http://www.daniel.com/consequatur-quas-eum-et-labore-dolores-corporis-soluta"
                    }
                }
            },
            {
                "id": 13,
                "name": "Summer Feest",
                "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": "Facere inventore quo quia id illo hic ex harum cupiditate ullam."
                    },
                    "description": {
                        "en": "Sunt eligendi corrupti voluptatem nam eveniet quas dolorem non. Consequatur et et commodi. Soluta vel officiis omnis dolorem sint numquam."
                    },
                    "url": {
                        "en": "http://www.vandervort.com/enim-magni-ut-quis-voluptas-molestias-quos.html"
                    }
                }
            }
        ],
        "category_groups": [
            {
                "name": "...",
                "category_ids": [
                    13,
                    16,
                    14
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    17,
                    17,
                    18
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    15,
                    12,
                    17
                ]
            }
        ]
    },
    {
        "id": 19,
        "name": "Oda Wolf",
        "address": {
            "street": "Sint-Denijslaan",
            "nr": "96",
            "zipcode": "9000",
            "city": "Gent",
            "country": "BE",
            "position": {
                "latitude": 1.54361,
                "longitude": 0.45645
            }
        },
        "offers": [
            {
                "id": 14,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 11,
                        "percentage": 11,
                        "minimum": 13
                    },
                    {
                        "type": "product",
                        "item_id": 19,
                        "percentage": 10,
                        "minimum": 10
                    },
                    {
                        "type": "product",
                        "item_id": 17,
                        "percentage": 13,
                        "minimum": 15
                    }
                ]
            },
            {
                "id": 14,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 19,
                        "percentage": 15,
                        "minimum": 16
                    },
                    {
                        "type": "product",
                        "item_id": 18,
                        "percentage": 12,
                        "minimum": 10
                    },
                    {
                        "type": "product",
                        "item_id": 15,
                        "percentage": 13,
                        "minimum": 18
                    }
                ]
            },
            {
                "id": 19,
                "name": "...",
                "items": [
                    {
                        "type": "product",
                        "item_id": 11,
                        "percentage": 14,
                        "minimum": 16
                    },
                    {
                        "type": "product",
                        "item_id": 13,
                        "percentage": 12,
                        "minimum": 18
                    },
                    {
                        "type": "product",
                        "item_id": 13,
                        "percentage": 16,
                        "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": false
            }
        },
        "allow_comments": false,
        "allow_orders": true,
        "delivery_use_intervals": true,
        "categories": [
            {
                "id": 15,
                "name": "Casimir Wolff III",
                "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": "Est sunt provident totam explicabo quo commodi quae."
                    },
                    "description": {
                        "en": "Magni et cumque mollitia. Est ut iste nihil velit reiciendis a."
                    },
                    "url": {
                        "en": "http://www.stanton.com/quis-ut-iusto-qui-soluta"
                    }
                }
            },
            {
                "id": 12,
                "name": "Devin Christiansen",
                "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": "Quam in odio enim vel consequatur."
                    },
                    "description": {
                        "en": "Consequatur et facilis eaque dolores. Suscipit nulla hic nemo ipsum."
                    },
                    "url": {
                        "en": "http://www.larson.info/"
                    }
                }
            },
            {
                "id": 17,
                "name": "Kyler Johns",
                "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": "Rem eveniet repudiandae soluta quos temporibus consectetur voluptas tempore."
                    },
                    "description": {
                        "en": "Modi non deserunt non sit. Perspiciatis assumenda et omnis qui omnis dolor similique. Sint illo dolor veniam deleniti."
                    },
                    "url": {
                        "en": "http://www.turner.org/"
                    }
                }
            }
        ],
        "category_groups": [
            {
                "name": "...",
                "category_ids": [
                    19,
                    11,
                    17
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    17,
                    15,
                    19
                ]
            },
            {
                "name": "...",
                "category_ids": [
                    15,
                    10,
                    17
                ]
            }
        ]
    }
]
Version update available Please adjust your integration to the latest stable version (1.9.0)
0.2.0 stable