/opentable/restaurants

POST /api/opentable/restaurants

Price: 20 credits

Get an OpenTable restaurant by its id: address, coordinates, contacts, cuisines, price band, hours, ratings, the full structured menu with sections, items and prices, private dining, experiences and the newest reviews

How to use it

Fetch one OpenTable restaurant by the numeric id that search and autocomplete return. menus holds the restaurant's structured menu; when it is empty, menu_url may link to a menu hosted elsewhere. review_count counts the text reviews that opentable/restaurants/reviews returns; rating_count is the number of ratings behind the averages, all-time or recent as rating_basis says.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• restaurant_id integer required — OpenTable restaurant id (examples: 2, 1029757; min: 1)

Response

• @type string (default: "OpentableRestaurantProfile")
• id integer required
• url string required
• alias string nullable
• name string required
• listing_type string nullable
• description string nullable
• primary_cuisine string nullable
• cuisines array (default: [])
• price_band integer nullable
• price_band_name string nullable
• currency string nullable
• address object nullable
  • @type string (default: "OpentableAddress")
  • line1 string nullable
  • line2 string nullable
  • city string nullable
  • state string nullable
  • post_code string nullable
  • country string nullable
  • country_code string nullable
• cross_street string nullable
• latitude number nullable
• longitude number nullable
• neighborhood string nullable
• neighborhood_id integer nullable
• metro string nullable
• metro_id integer nullable
• macro_id integer nullable
• time_zone string nullable
• phone string nullable
• email string nullable
• website string nullable
• facebook_url string nullable
• order_online_url string nullable
• gift_card_url string nullable
• hours string nullable
• dining_style string nullable
• dress_code string nullable
• executive_chef string nullable
• entertainment string nullable
• catering string nullable
• parking string nullable
• parking_details string nullable
• public_transit string nullable
• payment_options array (default: [])
• amenities array (default: [])
• is_permanently_closed boolean nullable
• has_bar_seating boolean nullable
• has_counter_seating boolean nullable
• has_high_top_seating boolean nullable
• has_outdoor_seating boolean nullable
• has_takeout boolean nullable
• has_delivery boolean nullable
• has_waitlist boolean nullable
• reservation_max_party_size integer nullable
• max_advance_days integer nullable
• recent_booking_count integer nullable
• image string nullable
• photos array (default: [])
  • @type string (default: "OpentablePhoto")
  • id string required
  • image string required
  • caption string nullable
  • category string nullable
  • source string nullable
  • created_at integer nullable
  • width integer nullable
  • height integer nullable
• photo_count integer nullable
• rating object nullable
  • @type string (default: "OpentableRatings")
  • overall number nullable
  • food number nullable
  • service number nullable
  • ambience number nullable
  • value number nullable
  • noise number nullable
  • count integer nullable
  • food_count integer nullable
  • service_count integer nullable
  • ambience_count integer nullable
  • value_count integer nullable
  • distribution array (default: [])
    • @type string (default: "OpentableRatingDistribution")
    • stars integer required
    • count integer required
• rating_basis string nullable
• rating_count integer nullable
• review_count integer nullable
• review_summary string nullable
• review_tags array (default: [])
• external_ratings array (default: [])
  • @type string (default: "OpentableExternalRating")
  • source string required
  • rating number nullable
  • count integer nullable
• awards array (default: [])
  • @type string (default: "OpentableAward")
  • name string required
  • year integer nullable
  • rating string nullable
  • location string nullable
• popular_dishes array (default: [])
  • @type string (default: "OpentablePopularDish")
  • id string required
  • name string nullable
  • description string nullable
  • review_count integer nullable
  • image string nullable
• menu_url string nullable
• menus array (default: [])
  • @type string (default: "OpentableMenu")
  • description string nullable
  • currency string nullable
  • provider string nullable
  • provider_image string nullable
  • updated_at integer nullable
  • sections array (default: [])
    • @type string (default: "OpentableMenuSection")
    • description string nullable
    • menu_items array (default: [])
• delivery_partners array (default: [])
  • @type string (default: "OpentableDeliveryPartner")
  • id integer required
  • name string nullable
  • menu_url string nullable
  • is_active boolean nullable
• dining_areas array (default: [])
  • @type string (default: "OpentableDiningArea")
  • id integer required
  • name string nullable
  • description string nullable
  • tag string nullable
  • is_active boolean nullable
• private_dining object nullable
  • @type string (default: "OpentablePrivateDining")
  • has_private_dining boolean nullable
  • has_enhanced_private_dining boolean nullable
  • description string nullable
  • contact string nullable
  • phone string nullable
  • largest_capacity integer nullable
  • url string nullable
  • rooms array (default: [])
    • @type string (default: "OpentablePrivateRoom")
    • id string required
    • name string nullable
    • description string nullable
    • seated_capacity integer nullable
    • standing_capacity integer nullable
    • minimum_capacity integer nullable
    • environment string nullable
    • privacy string nullable
    • image string nullable
• experiences array (default: [])
  • @type string (default: "OpentableExperience")
  • id integer required
  • name string nullable
  • description string nullable
  • experience_type string nullable
  • is_bookable boolean nullable
  • is_sold_out boolean nullable
  • start_date string nullable
  • end_date string nullable
  • min_party_size integer nullable
  • max_party_size integer nullable
  • image string nullable
• faqs array (default: [])
  • @type string (default: "OpentableFaq")
  • question string required
  • answer string nullable
• press array (default: [])
  • @type string (default: "OpentableArticle")
  • source string nullable
  • summary string nullable
  • url string nullable
  • published_at integer nullable
• editorial_lists array (default: [])
  • @type string (default: "OpentableEditorialList")
  • id string required
  • name string nullable
  • description string nullable
  • url string nullable
• reviews array (default: [])
  • @type string (default: "OpentableReview")
  • id string required
  • restaurant_id integer required
  • text string nullable
  • rating_overall integer nullable
  • rating_food integer nullable
  • rating_service integer nullable
  • rating_ambience integer nullable
  • rating_value integer nullable
  • noise_level string nullable
  • submitted_at integer nullable
  • dined_at integer nullable
  • review_type string nullable
  • is_from_previous_concept boolean nullable
  • helpful_count integer nullable
  • unhelpful_count integer nullable
  • helpfulness_score number nullable
  • reviewer object nullable
    • @type string (default: "OpentableReviewAuthor")
    • nickname string nullable
    • initials string nullable
    • metro string nullable
    • metro_id integer nullable
    • review_count integer nullable
    • is_vip boolean nullable
    • image string nullable
  • photos array (default: [])
    • @type string (default: "OpentableReviewPhoto")
    • id string required
    • image string required
    • caption string nullable
  • restaurant_reply object nullable
    • @type string (default: "OpentableRestaurantReply")
    • text string required
    • replied_at integer nullable

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — No OpenTable restaurant has this id. Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.