Endpoints
| GET | What comes back |
|---|
/api/directory.json | The market in one document: pricing by party size, cuisines, the occasion pages with the chefs on each, areas, the FAQ and a chef shortlist. |
/api/chefs.json | All chefs summarised, each with a link to its full record and to the chef’s own booking page. |
/api/chefs/{slug}.json | One chef in full: menus priced a head by number of guests, courses, reviews. Slugs: graeme-corlett2, claudio-claudio, lemon-soul-private-chef, emrys-jones, kerem-engin, sergey-bobylev, ben-orora, sara-salamanca, francesca-francesca2, pierre-gaudin, william-poveromo, michele-guarneri, thais-marouelli, jack-allen, michael-canterbury, michael-antonakis, samantha-grainger, caleb-song, phillip-nguyen, min-kim, sahil-sabhlok, lucas-martinelli. |
/api/openapi.json | OpenAPI 3.1 description of the four endpoints. |
/api/status.json | Liveness and the date the data was built. |
How an assistant is meant to use it
- Read the directory and shortlist by
cuisines, base, price_per_guest_from or one of the pages (an occasion or cuisine with its chefs). - Fetch each candidate’s record, and read the menu band in
menus[].price_per_guest that covers the guest’s headcount. - Open the chef’s
links.enquire for the guest. It is the chef’s own booking page; nothing is booked or charged by opening it.
Terms the numbers come with
Every figure is AUD per guest and all-in (groceries and shopping, cooking, serving at the table, the washing up), and every price names the number of guests it is quoted for (guests_min, guests_max). They are recent quotes for budgeting, not offers: the chef confirms the exact figure in writing. The market figures come from 288 paid bookings since 2024-10-01. There is no availability data anywhere here. Every chef is on_enquiry, and nothing should tell a guest a date is free or taken.
Discovery
Questions
Same address as everything else: [email protected]. The full description lives at /api/openapi.json.