Market Data

Restaurant Details

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.

post/restaurant_details

Request

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

Request body

user_idstring uuid required

Authorized user identifier used for authentication and rate limiting.

restaurant_idnumber

Restaurant identifier to look up. Returns one restaurant with full details. Required when query is not provided.

querystring

Restaurant name to search for (minimum 3 characters, for example French Laundry). Activates search mode. Required when restaurant_id is not provided.

citystring

Narrows a query to restaurants whose address contains this city.

statestring

Narrows a query by state or region.

countrystring

Narrows a query by country (US, USA and United States are treated the same).

michelin_starsnumber

Narrows a query to restaurants with exactly this many Michelin stars.

limitnumber

Maximum results returned in search mode (1-20).

offsetnumber

Pagination offset for search mode (0-200).

Response

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 required

Changes

No recorded changes to this operation across all 1 revision of this API.