GET

OpenTable Restaurant Details API

Get a live, normalized OpenTable restaurant profile from one numeric restaurant ID.

Overview

Direct profile fetch — no browser required

StayAPI fetches and parses the restaurant profile over HTTP. Callers do not need Chrome, Browserless, cookies, or an OpenTable session.

Supply the stable restaurant_id returned by Restaurant Search or URL to Restaurant ID. The response combines identity, editorial content, ratings, location, contact information, operating details, photos, policies, and OpenTable feature flags in one JSON object.

Endpoint URL

GET https://api.stayapi.com/v1/opentable/restaurants/{restaurant_id}

Path Parameter

Parameter	Type	Required	Description
restaurant_id	integer	Required	Positive numeric OpenTable restaurant ID, such as `404046`.

Response Fields

Field	Description
id, name, url	Restaurant identity and canonical OpenTable profile URL.
description, review_summary	Restaurant description and OpenTable's editorial review summary.
primary_cuisine, cuisines, dining_style, price_band	Cuisine taxonomy, dining style, and localized price information.
rating, ratings	Overall rating plus food, service, ambience, and value ratings.
review_count, text_review_count, recent_reservation_count	Review volume and recent reservation activity.
address, coordinates, neighborhood, metro, macro	Street address, latitude/longitude, and OpenTable location hierarchy.
contact, website, hours	Phone, email, website, and opening-hours text.
dress_code, parking, public_transit, cross_street	Arrival and venue guidance when supplied by the restaurant.
payment_options, additional_details	Accepted payments and restaurant amenities.
photos, photo_count	OpenTable-hosted photo URLs and the profile's photo count.
max_advance_days, max_party_size	Reservation-window and party-size limits.
has_takeout, order_online_link, private_dining	Takeout, online ordering, and private-dining details.
dining_areas, time_zone, features	Bookable areas, timezone metadata, and seating or availability flags.

Stable null and list handling

Fields OpenTable does not supply remain null, while collection fields such as cuisines, photos, payment_options, and dining_areas remain empty arrays.

Error Responses

Errors follow RFC 7807 Problem Details with provider: "opentable" and product: "details".

404 Restaurant not found

RESTAURANT_NOT_FOUND when OpenTable has no profile for the supplied ID.

502 Upstream error

UPSTREAM_ERROR when OpenTable cannot be fetched or parsed after retries.

Related Endpoints

URL to Restaurant ID

Resolve a profile URL before requesting details.

View Documentation →

Restaurant Reviews

Fetch paginated guest reviews for the same restaurant ID.

View Documentation →

Request

curl "https://api.stayapi.com/v1/opentable/restaurants/404046" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch(
  'https://api.stayapi.com/v1/opentable/restaurants/404046',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.json());

import requests

response = requests.get(
    "https://api.stayapi.com/v1/opentable/restaurants/404046",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
response.raise_for_status()
print(response.json())

<?php
$ch = curl_init('https://api.stayapi.com/v1/opentable/restaurants/404046');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-API-Key: YOUR_API_KEY']);
echo curl_exec($ch);
curl_close($ch);

require 'net/http'
require 'json'

uri = URI('https://api.stayapi.com/v1/opentable/restaurants/404046')
request = Net::HTTP::Get.new(uri)
request['X-API-Key'] = 'YOUR_API_KEY'
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request) }
puts JSON.pretty_generate(JSON.parse(response.body))

Response

{
  "success": true,
  "restaurant": {
    "id": 404046,
    "name": "Le Petit Saint Honoré",
    "url": "https://www.opentable.com/r/le-petit-saint-honore-paris",
    "description": "Le Petit Saint-Honoré welcomes you …",
    "review_summary": "Le Petit Saint Honoré offers a charming dining experience …",
    "website": "http://www.lepetitsainthonore.fr/",
    "primary_cuisine": "French",
    "cuisines": ["French", "Traditional French"],
    "dining_style": "Casual Dining",
    "price_band": {"id": 2, "name": "€30 and under", "currency_symbol": "€"},
    "rating": 4.4,
    "ratings": {"overall": 4.4, "food": 4.4, "service": 4.4, "ambience": 4.5, "value": 4.3},
    "review_count": 201,
    "text_review_count": 80,
    "recent_reservation_count": 12,
    "address": {
      "line1": "158 Rue Saint-Honoré",
      "line2": "",
      "city": "Paris",
      "state": "Ile-de-France",
      "postal_code": "75001",
      "country": "France"
    },
    "coordinates": {"latitude": 48.8623994, "longitude": 2.3450701},
    "contact": {"phone": "01 42 60 08 06", "email": null},
    "hours": "Daily 9:00 am–12:00 am",
    "photos": ["https://resizer.otstatic.com/v3/photos/86428591-3"],
    "photo_count": 47,
    "max_advance_days": 90,
    "max_party_size": 9,
    "private_dining": {"available": false, "largest_capacity": 0},
    "neighborhood": {"id": 16454, "name": "Châtelet"},
    "metro": {"id": 3408, "name": "Paris"},
    "macro": {"id": 9080},
    "features": {"outdoor": true, "waitlist": false}
  }
}

{
  "type": "https://api.stayapi.com/errors/restaurant-not-found",
  "title": "Restaurant Not Found",
  "status": 404,
  "detail": "OpenTable restaurant was not found",
  "instance": "/v1/opentable/restaurants/404046",
  "provider": "opentable",
  "product": "details",
  "error_code": "RESTAURANT_NOT_FOUND",
  "correlation_id": "request-id",
  "restaurant_id": 404046
}