OpenTable Data API

Access restaurant data from OpenTable. Search restaurants, get profiles, and read reviews.

原始信息汇总

OpenTable Data API 数据集概述

基本信息

• API名称: OpenTable Data API
• 提供者: elis-lab
• 类别: Food
• 订阅者数量: 3
• 订阅计划:
  • BASIC: $0.00 / mo
  • PRO: $10.00 / mo
  • ULTRA: $40.00 / mo
  • MEGA: $150.00 / mo
• API评分:
  • 流行度: 8.7
  • 服务等级: 86%
  • 延迟: 1577ms

核心功能

• 访问 OpenTable 全球超过 60,000 家餐厅的网络数据。
• 按地点、日期、用餐人数等条件搜索餐厅。
• 获取包含营业时间、着装要求、停车信息、厨师、特色体验等在内的完整餐厅详细信息。
• 读取包含食物、服务、氛围和价值评分的详细评论。
• 提供位置和餐厅名称的自动补全功能。
• 每个餐厅包含 50 多个数据字段，涵盖照片、坐标和特色信息。
• 支持分页，每页最多返回 50 条结果。

端点列表

方法	路径	描述
GET	/search	按地点、日期、用餐人数搜索餐厅
GET	/restaurant/{slug}	获取完整的餐厅详细信息
GET	/restaurant/{slug}/reviews	获取餐厅评论
GET	/autocomplete	位置和餐厅名称自动补全

主要参数说明

搜索参数 (/search)

参数	类型	必需	描述
dateTime	string	是	ISO 8601 日期/时间 (例如 2026-06-01T19:00:00)
covers	integer	是	用餐人数 (1+)
metroId	integer	否	大都市区 ID (来自自动补全)
term	string	否	自由文本搜索 (菜系、餐厅名称)
cuisineId	integer	否	按菜系 ID 筛选
page	integer	否	页码 (默认: 1，每页 50 条结果)
sortBy	string	否	web_conversion, rating, 或 nearest
latitude	number	否	搜索中心纬度
longitude	number	否	搜索中心经度

餐厅详情参数 (/restaurant/{slug})

参数	类型	必需	描述
slug	string	是	餐厅 URL 标识符 (例如 parche-oakland)

评论参数 (/restaurant/{slug}/reviews)

参数	类型	必需	描述
slug	string	是	餐厅 URL 标识符
sortBy	string	否	newestReview, oldestReview, highestRating, lowestRating

自动补全参数 (/autocomplete)

参数	类型	必需	描述
term	string	是	搜索文本
latitude	number	否	用户纬度 (用于相关性排序)
longitude	number	否	用户经度 (用于相关性排序)

响应数据字段

搜索餐厅字段

• restaurantId — 唯一餐厅 ID
• name — 餐厅名称
• diningStyle — 用餐风格 (例如 Casual Dining, Fine Dining)
• priceBandName — 价格范围 (例如 "$31 to $50")
• primaryCuisine — 主要菜系类型
• neighborhood — 所在街区名称
• overallRating — 总体评分 (0-5)
• foodRating, serviceRating, ambienceRating, valueRating — 分类评分
• reviewCount — 评论总数
• recentReservationCount — 近期预订数
• address — 完整地址 (包含 line1, city, state, postCode)
• latitude, longitude — 坐标
• photos — 照片 URL
• profileUrl — 完整资料链接 (可从中提取 slug 用于详情端点)

餐厅详情字段 (额外字段)

• phone — 电话号码
• website — 餐厅网站
• hoursOfOperation — 营业时间
• dressCode — 着装要求
• parkingInfo — 停车详情
• publicTransit — 附近公共交通
• crossStreet — 交叉街道
• executiveChef — 主厨姓名
• cuisines — 所有菜系类型
• experiences — 特色用餐体验及价格
• hasTakeout, hasDeliveryPartners — 外卖/配送选项

评论字段

• reviewId — 唯一评论 ID
• text — 评论正文
• overallRating — 1-5 评分
• foodRating, serviceRating, ambienceRating, valueRating — 分类评分
• noiseLevel — 噪音水平 (例如 "MODERATE")
• userNickname — 评论者昵称
• userIsVip — 是否为 VIP 食客
• submittedDate — 评论提交日期
• dinedDate — 用餐日期
• restaurantReply — 餐厅回复 (如有)

分页

• 搜索结果每页返回 50 家餐厅。
• 使用 page 参数进行分页。
• 响应中的 totalRestaurantCount 字段表示结果总数。

常见大都市区 ID

Metro ID	城市
8	New York City
4	San Francisco Bay Area

错误代码

代码	描述
200	成功
404	餐厅未找到
422	验证错误 (检查 errors 数组)
502	上游错误 (OpenTable 服务不可用)