Restaurants

WARNING

The Taste Maps API and dataset are currently in early access, with initial coverage focused on Staffordshire. We're using this phase to fine-tune accuracy and reliability before rapidly expanding to additional regions.

The core focus of Taste Maps is high-quality menu ingestion. While we include basic restaurant information, restaurants primarily serve as logical containers for menus within our system. We anticipate that many platforms consuming this API may already have their own restaurant datasets - but this is not required to use our service.

GET /v1/restaurants

Fetches a paginated list of restaurants.

Query Parameters

• page (optional): Page to return
• pageSize (optional): Amount of restaurants to return per page
• name (optional): Filter by restaurant name
• city (optional): Filter by city
• cuisine (optional): Filter by cuisine

curl --location 'https://api.tastemaps.co.uk/v1/restaurants' \
--header 'Authorization: Bearer <TOKEN>'

Response

• id: GUID of the restaurant
• name: Name of the restaurant
• location: City and Postcode of the restaurant
• activeMenus: The amount of active menus we have for the restaurant
• cuisine: The cuisine that the restaurant specialises in or the type of establishment if the cuisine isn't obvious

{
  "items": [
    {
      "id": "d7969eb3-0ca3-4158-5c4a-08ddabeb4892",
      "name": "Ali's Stafford",
      "location": "Stafford, ST16 2EZ",
      "activeMenus": 1,
      "cuisine": "Takeaway"
    },
    {
      "id": "3e120e79-f34c-4a24-5c32-08ddabeb4892",
      "name": "Anatolian Palace",
      "location": "Stafford, ST16 2PJ",
      "activeMenus": 3,
      "cuisine": "Takeaway"
    },
    {
      "id": "7981d5e7-9c03-42c3-5c9d-08ddabeb4892",
      "name": "Aperitif Bar",
      "location": "Stafford, ST19 9BS",
      "activeMenus": 0,
      "cuisine": "Bar"
    },
    {
      "id": "42561a40-c054-4bb3-5c31-08ddabeb4892",
      "name": "Ayo Gorkhali",
      "location": "Stafford, ST16 2QT",
      "activeMenus": 2,
      "cuisine": "Nepalese"
    },
    {
      "id": "08cac752-c85a-4d3e-5c51-08ddabeb4892",
      "name": "Barley Mow Pub & Grill",
      "location": "Stafford, ST17 0UW",
      "activeMenus": 7,
      "cuisine": "Takeaway"
    },
    {
      "id": "0cdb4998-2994-492f-5c4b-08ddabeb4892",
      "name": "Bear Stafford",
      "location": "Stafford, ST16 2HP",
      "activeMenus": 0,
      "cuisine": "Pub"
    },
    {
      "id": "1f7f94ff-8584-460c-5c98-08ddabeb4892",
      "name": "Bell Inn",
      "location": "Stafford, ST21 6BZ",
      "activeMenus": 4,
      "cuisine": "Takeaway"
    },
    {
      "id": "bade7599-ba83-4c2c-5c3b-08ddabeb4892",
      "name": "Bengal Lounge",
      "location": "Stafford, ST16 2HY",
      "activeMenus": 1,
      "cuisine": "Indian"
    },
    {
      "id": "1d5555a1-6319-4887-5c53-08ddabeb4892",
      "name": "Betsy's x Little Dessert Shop Stafford",
      "location": "Stafford, ST16 2QZ",
      "activeMenus": 1,
      "cuisine": "FastFood"
    },
    {
      "id": "9ed03094-fb3d-401a-5c23-08ddabeb4892",
      "name": "Bistro Le Coq",
      "location": "Stafford, ST18 0LF",
      "activeMenus": 0,
      "cuisine": "Takeaway"
    }
  ],
  "totalCount": 129,
  "pageSize": 10,
  "currentPage": 1,
  "totalPages": 13,
  "hasPrevious": false,
  "hasNext": true
}

GET /v1/restaurants/:id

Fetches a detailed view of your chosen restaurant.

Query Parameters

• id: GUID of the restaurant

curl --location 'https://api.tastemaps.co.uk/v1/restaurants/1f7f94ff-8584-460c-5c98-08ddabeb4892' \
--header 'Authorization: Bearer <TOKEN>'

Response

• id: GUID of the restaurant

• name: Name of the restaurant

• phoneNumber: The phone number of the restaurant

• cuisine: The cuisine that the restaurant specialises in or the type of establishment if the cuisine isn't obvious

• street: The street the restaurant is on

• city: The city the restaurant is in

• postcode: The postcode of the restaurant

• country: The country the restaurant is in

• latitude: The latitude of the restaurant. Currently set to 0. This will be accurate on production

• longitude: The longitude of the restaurant. Currently set to 0. This will be accurate on production

• menus

  • id: ID of the menu
  • version: The version of the menu. When we detect changes to the menu we reimport the whole menu and create a new version. The old version history is still accessible this way
  • name: The name of the menu

{
  "id": "1f7f94ff-8584-460c-5c98-08ddabeb4892",
  "name": "Bell Inn",
  "phoneNumber": "+44 1785 850378",
  "cuisine": "Takeaway",
  "street": "16 High St",
  "city": "Stafford",
  "postcode": "ST21 6BZ",
  "country": "United Kingdom",
  "latitude": 0,
  "longitude": 0,
  "menus": [
    {
      "id": 37,
      "version": 1,
      "name": "Dessert Menu"
    },
    {
      "id": 38,
      "version": 1,
      "name": "Lunch Menu"
    },
    {
      "id": 57,
      "version": 1,
      "name": "Sunday Menu"
    },
    {
      "id": 58,
      "version": 1,
      "name": "Main Menu"
    }
  ]
}