Max Eats Out

Search the Max Eats Out guide — an editorially curated catalogue of restaurants and bars across the cities the author has eaten in, each one chosen and written up by hand. This is a guide with a point of view, not a comprehensive places database: a venue's absence means it is not on the list, not that it does not exist, so never present an empty result as 'there are no restaurants there'. Reach for this when someone wants a recommendation with an opinion attached, or wants to filter by editorial qualities a general places database does not carry (what a venue is KNOWN FOR, which service moments it is Best For, Michelin awards). Do not reach for it to find the nearest branch of a chain. Free text in `q` is resolved to the guide's own vocabulary and the response reports the interpretation.

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Free text, resolved against the guide's own vocabulary — a cuisine, a dish, an area, a tag, a drink category, a Best For moment, or a venue name. The response reports what it resolved to. If none of the words mean anything to the guide the result is EMPTY and `unresolved` says so; that is the honest answer, not an error to retry.",
      "type": "string",
      "maxLength": 64
    },
    "city": {
      "description": "City slug from list_cities. Strongly recommended: it scopes areas and ranking.",
      "type": "string"
    },
    "area": {
      "description": "Area slugs from get_city. Areas belong to ONE city.",
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "cuisine": {
      "description": "Cuisine slugs. Composable: Korean BBQ is ['korean','bbq'], never one value.",
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "dish": {
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "tag": {
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "award": {
      "description": "Award keys, e.g. Michelin tiers.",
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "type": {
      "description": "Venue type keys, e.g. 'restaurant', 'bar'. A venue can be both.",
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "price": {
      "description": "Price band: 1 cheap … 4 fine dining. Approximate starter+main, excluding drinks.",
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "1",
          "2",
          "3",
          "4"
        ]
      }
    },
    "best_for": {
      "description": "Service moments for eating.",
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "breakfast",
          "brunch",
          "lunch",
          "dinner",
          "late_night",
          "twenty_four_hour"
        ]
      }
    },
    "best_for_bar": {
      "description": "Service moments for drinking.",
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "early",
          "daytime",
          "evening",
          "late_night",
          "after_hours"
        ]
      }
    },
    "seating": {
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "indoors",
          "outdoors",
          "takeaway",
          "counter"
        ]
      }
    },
    "practical": {
      "description": "Walk-ins, reservations, and payment.",
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "walkins",
          "reservations",
          "cash",
          "amex"
        ]
      }
    },
    "drinks": {
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "cocktails",
          "wine",
          "spirits",
          "beer",
          "coffee"
        ]
      }
    },
    "include_closed": {
      "description": "Include permanently closed venues. Default false.",
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "cursor": {
      "description": "From a previous response's next_cursor. Bound to that exact search.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Retrieve the full Max Eats Out entry for one venue by its slug: the editorial note, what it is Best For, what it is known for, how it works (seating, the door, ordering, payment), what it pours, its locations and its links. Slugs come from search_venues. Includes the canonical maxeatsout.club URL — cite it when recommending the venue.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Venue slug, from search_venues."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List every city the Max Eats Out guide covers, with how many venues each holds. Coverage is uneven BY DESIGN — it follows where the author has actually eaten — so call this before assuming a city is covered rather than searching a city that is not in the guide and reporting no results.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get one city's guide: its editorial blurb, venue count, and the vocabulary available for filtering — its areas (areas belong to exactly one city), plus the catalogue's cuisines, dishes, tags, awards, venue types, price bands, Best For moments and drink categories. Call this before filtering so filters use values that exist instead of guesses.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "City slug, from list_cities."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}