Get Venue Recommendations
Returns machine-learning product recommendations for a venue — the "popular right now" style list you would show on a store landing page.
This is venue-wide, not personalized: it takes no cart and no customer context, so the same venue returns the same list for every caller. For suggestions based on what is already in the basket, use the cart cross-sell endpoint in Cart 2.0 instead.
The feature is off by default. When the brand does not have ML suggestions enabled, or the upstream service is unavailable, the endpoint returns 200 with an empty products array rather than an error — so treat an empty list as normal and simply render nothing.
Path Parameters
- Type: stringvenue
_uuid requiredUUID of venue
Query Parameters
- Type: stringFormat: uuid
Optional menu UUID. When given, each recommended product is resolved against that menu where possible; products not in it fall back to their first available menu.
Headers
- Type: stringApplicationrequired
White Label Application Key
Responses
- application/json
- 403
The brand is not on the NMG product structure.
- 404
Unknown venue UUID, or the venue is not visible to this application.
curl 'https://api-public-demo.menu.app/api/v2/venues/{venue_uuid}/recommendations' \
--header 'Application: '
{
"status": "OK",
"code": 200,
"data": {
"products": [
{
"id": "289013d8-ce7b-424e-8f5f-2be2ece9c7a4",
"name": "Cheeseburger",
"description": "",
"price_id": "c41a9b02-0f21-4f7e-9a3a-1d2e3f4a5b6c",
"price": 950,
"menu_id": "9b1f2c3d-4e5a-6b7c-8d9e-0f1a2b3c4d5e",
"category_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"product_group_ids": [
"7dd73610-b4d4-4645-a839-afc840db344e"
],
"in_stock": true,
"out_of_stock_until": null,
"show_in_menu": true,
"is_alcoholic": false,
"is_self_serving": false,
"is_product_container": false,
"state": 1,
"position": 0,
"calories": null,
"image": null,
"allergens": [],
"food_types": []
}
]
}
}