---
title: "Restaurant Details"
method: POST
path: "/restaurant_details"
tags: ["Market Data"]
---

# Restaurant Details

`POST /restaurant_details`

## Request

- Base URL: `https://external-api.wine-labs.com`
- URL: `https://external-api.wine-labs.com/restaurant_details`
- Auth: none declared

Find a restaurant by name and get its `restaurant_id`, or look up one restaurant by `restaurant_id`. Use the id with Restaurant Listings to pull that restaurant's wine list.

## Request body

- object
  - `user_id` string, uuid, required: Authorized user identifier used for authentication and rate limiting.
  - `restaurant_id` number: Restaurant identifier to look up. Returns one restaurant with full details. Required when `query` is not provided.
  - `query` string: Restaurant name to search for (minimum 3 characters, for example `French Laundry`). Activates search mode. Required when `restaurant_id` is not provided.
  - `city` string: Narrows a `query` to restaurants whose address contains this city.
  - `state` string: Narrows a `query` by state or region.
  - `country` string: Narrows a `query` by country (`US`, `USA` and `United States` are treated the same).
  - `michelin_stars` number: Narrows a `query` to restaurants with exactly this many Michelin stars.
  - `limit` number: Maximum results returned in search mode (1-20).
  - `offset` number: Pagination offset for search mode (0-200).

## Response `200`

Response highlights:
- Search mode returns `results[]`, each with only:
- `restaurant_id`: identifier to pass to Restaurant Listings or back to this endpoint.
- `restaurant_address`: address, to tell restaurants with the same name apart.
- `has_wine_list`: whether Wine Labs holds a wine list for this restaurant.
- Lookup by `restaurant_id` returns one object with `restaurant_id`, `restaurant_name`, `restaurant_address`, `restaurant_country`, `restaurant_state`, `restaurant_phone`, `restaurant_website`, `restaurant_lat`, `restaurant_lng`, `offers_count`, `michelin_stars`, `has_wine_list`, `winelist_last_checked_at`.

Notes:
- Either `restaurant_id` or `query` must be provided. `city`, `state`, `country` and `michelin_stars` only narrow a `query`; they cannot be used on their own.
- Search results are ordered by the number of wine list offers we hold, then Michelin stars, then name.
- Uses the general details rate limits (a fraction of your market data quota).

- object

---

[API](https://skmtc.dev/winelabs/apis/wine-labs-api.md) · [All operations](https://skmtc.dev/winelabs/apis/wine-labs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/winelabs/apis/wine-labs-api/revisions/f8898ca9974e?raw)