Skip to main content
Piloterr
Back to library

TheFork Restaurant API

Extract a full TheFork restaurant profile from a restaurant page URL, including ratings, tags, photo gallery, opening hours, and AI review summaries via browser rendering.

Active2 credits = 1 requestGET/v2/thefork/restaurant

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Extract the full public profile of any TheFork restaurant page (/restaurant/{slug}-r{id}). Returns ratings (TheFork + TripAdvisor), cuisine, average price, address, photo gallery, amenity tags, opening hours, and AI review summaries.

TheFork restaurant pages are Next.js SPAs. Photos, tags, ratings, and opening hours are fetched client-side via GraphQL. Piloterr uses website rendering to load the page in a browser, wait for the restaurant profile to hydrate, and scrape structured JSON from the rendered DOM.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/thefork/restaurant?query=https://www.thefork.fr/restaurant/salamboo-amilkar-r10892

ParametersLink to Parameters

Parameter Type Required Description
query string yes Full TheFork /restaurant/{slug}-r{id} URL

Response fieldsLink to Response fields

Field Type Description
id integer TheFork restaurant ID
url string Canonical restaurant URL
name string Restaurant name
slug string URL slug
uuid string TheFork UUID
cuisine string Primary cuisine
currency string Price currency
avg_price number Average menu price
description string | null Restaurant description when available
image string Main photo URL
images array Full photo gallery URLs
address object { street, locality, zip_code, country }
geolocation object { latitude, longitude }
is_bookable boolean Online booking available
reviews_summary string AI-generated review summary
ratings.thefork.rating number TheFork score (0-10)
ratings.thefork.reviews_count integer TheFork review count
ratings.tripadvisor.rating number | null TripAdvisor score
ratings.tripadvisor.reviews_count integer | null TripAdvisor review count
tags array Amenity and cuisine tags (id, name, category, is_published)
opening_time_information.opening_hours object Weekly slots keyed by weekday (mon..sun), each slot { start, end } in minutes from midnight

NotesLink to Notes

  • Works on all TheFork country domains.
  • Opening hours use minute offsets (720 = 12:00, 870 = 14:30).
  • description may be null on some listings.
  • tags include payment methods, dietary options, ambiance, and location labels.
  • Hash parameters in the URL (#date=...) are accepted but optional.

Main use casesLink to Main use cases

  • Enrich CRM and directory records with restaurant contact and amenity data
  • Compare TheFork vs TripAdvisor ratings for reputation monitoring
  • Extract opening hours and bookability for reservation workflows
  • Build food discovery apps with photos, cuisine tags, and AI summaries

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included