TheFork Restaurant Intelligence API

Extract restaurants, reviews, menus from TheFork.com. 10 European countries. Real-time monitoring. Multi-format export.

原始信息汇总

TheFork Restaurant Intelligence API 数据集概述

数据集基本信息

• 数据集名称：TheFork Restaurant Intelligence API
• 数据来源：TheFork.com（欧洲领先的餐厅预订平台，覆盖10个国家，超过60,000家餐厅）
• 主要功能：提供欧洲餐厅数据提取的完整解决方案

核心功能

数据提取

• 餐厅数据提取：提取完整的餐厅列表，包括名称、评分、价格、菜系、地址、坐标
• 客户评论提取：提取完整的评论数据，包括评分、评论文本、用餐日期、评论者信息
• 菜单与照片提取：提取完整菜单（项目、描述、价格）和餐厅照片（官方和用户上传）
• 实时监控（Pro+及以上计划）：设置自动警报，跟踪评分变化、新评论、新餐厅开业和价格变化

数据导出

• 支持格式：JSON、CSV、XLSX、XML
• 格式可用性：
  • Basic计划：JSON
  • Pro计划：JSON、CSV
  • Ultra计划：JSON、CSV、XLSX
  • Mega计划：JSON、CSV、XLSX、XML

Webhooks（Pro+及以上计划）

• 功能：实时回调，接收事件发生时的数据
• 特点：可配置触发器、HMAC签名验证的安全交付

支持的国家

国家	域名	示例城市URL
法国	thefork.fr	https://www.thefork.com/restaurants/paris-c415144
意大利	thefork.it	https://www.thefork.com/restaurants/rome-c395919
西班牙	thefork.es	https://www.thefork.com/restaurants/barcelona-c10375
比利时	thefork.be	https://www.thefork.com/restaurants/brussels-c407972
荷兰	thefork.nl	https://www.thefork.com/restaurants/amsterdam-c365234
葡萄牙	thefork.pt	https://www.thefork.com/restaurants/lisbon-c416143
瑞士	thefork.ch	https://www.thefork.com/restaurants/geneva-c414788
德国	thefork.de	https://www.thefork.com/restaurants/berlin-c363901
奥地利	thefork.at	https://www.thefork.com/restaurants/vienna-c423034
英国	thefork.co.uk	https://www.thefork.com/restaurants/london-c382418

API端点

数据提取端点

• POST /restaurants：从城市页面提取餐厅列表
• POST /reviews：提取客户评论
• POST /menu：提取菜单和照片

数据导出端点（Pro+）

• GET /export/formats：获取可用格式
• POST /export/restaurants：导出餐厅数据

监控端点（Pro+）

• POST /monitoring/restaurants：跟踪餐厅变化
• POST /monitoring/cities：跟踪新餐厅
• GET /monitoring/alerts：获取触发的警报
• GET /monitoring/list：列出您的监控器
• GET /monitoring/limits：检查监控器配额
• DELETE /monitoring/{monitor_id}：删除监控器

Webhooks端点（Pro+）

• POST /webhooks/setup：创建Webhook
• GET /webhooks/list：列出您的Webhooks
• GET /webhooks/logs：获取交付历史
• DELETE /webhooks/{webhook_id}：删除Webhook

实用端点

• GET /info：API信息和计划限制
• GET /cities：列出可用城市
• GET /health：健康检查

定价计划

计划	月费	每月请求数	速率限制	最大餐厅数/请求	最大评论数/餐厅	功能
Basic	免费	50	1/秒	10	50	JSON导出
Pro	$39	1,000	5/秒	50	200	CSV、Webhooks、监控（5个）
Ultra	$99	5,000	10/秒	100	500	XLSX、监控（20个）、优先支持
Mega	$249	20,000	25/秒	500	1,000	XML、监控（100个）、专属支持

技术规格

• 批量提取：每个请求最多500家餐厅
• 评论提取：每家餐厅最多1,000条评论
• 多语言支持：评论过滤支持fr、en、it、es、de等语言
• 排序选项：按用餐日期或评分排序
• 时间范围过滤：1d、7d、1m、6m、1y、all
• 监控间隔：hourly、daily、weekly
• Webhook时间范围：1h、6h、12h、1d、7d、14d、1m

数据字段示例

餐厅数据

• id、name、url、rating、review_count、price_level、avg_price、currency、cuisines
• address（street、locality、postal_code、country）
• geolocation（lat、lng）、photos

评论数据

• id、rating、food_rating、service_rating、ambiance_rating、text
• reviewer_name、meal_date、language、likes_count

菜单数据

• 菜单类别（a_la_carte、preset_menus）
• 项目详情（name、description、price、currency）
• 厨师信息（name、title）
• 食物照片（url、caption）

搜集汇总

背景与挑战

背景概述

该API提供TheFork.com平台的餐厅数据，包括基本信息、用户评论及菜单内容，覆盖10个欧洲国家，支持实时数据监控并以多种格式导出。