Skip to main content
Network status
Log in
Piloterr
Back to library

TheFork Search API

Search TheFork restaurants from a full search or city URL and retrieve ratings, cuisine, prices, availability, review summaries, and pagination via browser rendering.

Active2 credits = 1 requestGET/v2/thefork/search
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Extract restaurant listings from any TheFork search or city browse page. Returns structured cards with ratings, cuisine, average price, address, geolocation, bookability, AI review summaries, and pagination metadata.

TheFork is a Next.js single-page application. Search results (RestaurantCard components) and availability data are loaded via GraphQL after the initial HTML shell. A plain HTTP request returns an empty page skeleton. Piloterr uses website rendering to execute JavaScript, wait for restaurant cards to render, and extract structured JSON from the live DOM.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/thefork/search?query=https://www.thefork.fr/search?cityId=529135&date=2026-06-13&hour=660&partySize=8&timezone=Europe%2FParis

Copy the full URL from thefork.fr. Use pagination.next_url for the next page (anchor-based: #list25, #list50, ...).

Supported URL formatsLink to Supported URL formats

Format Example
Search with filters https://www.thefork.fr/search?cityId=529135&date=2026-06-13&hour=660&partySize=8
City listing https://www.thefork.fr/restaurants/strasbourg-c529135

ParametersLink to Parameters

Parameter Type Required Description
query string yes Full TheFork /search or /restaurants/{city}-c{id} URL

Response fieldsLink to Response fields

Field Type Description
results array Restaurant listing cards
results[].id integer TheFork restaurant ID
results[].url string Restaurant page URL
results[].name string Restaurant name
results[].slug string URL slug
results[].uuid string TheFork UUID
results[].image string Main photo URL
results[].rating number TheFork score (0-10)
results[].reviews_count integer Number of reviews
results[].cuisine string Primary cuisine label
results[].currency string Price currency (e.g. EUR)
results[].avg_price number Average menu price
results[].address string Full formatted address
results[].geolocation object { latitude, longitude }
results[].is_bookable boolean Online booking available
results[].timeslots array Available time slots when date/hour filters are set
results[].review_snippets array Highlighted customer review excerpts
results[].reviews_summary string AI-generated review summary
pagination.current integer Current page number
pagination.next integer | null Next page number
pagination.next_url string | null Next page URL with anchor
pagination.total_pages integer Total pages
pagination.total_count integer Total matching restaurants
pagination.per_page integer Results on this page
pagination.has_next_page boolean Whether a next page exists

NotesLink to Notes

  • Works on all TheFork country domains (thefork.fr, thefork.com, thefork.it, ...).
  • hour is minutes from midnight (660 = 11:00).
  • timeslots may be empty when no date/time filter is applied.
  • Pass results[].url to TheFork Restaurant for tags, gallery, opening hours, and TripAdvisor ratings.

Main use casesLink to Main use cases

  • Build restaurant lead lists by city, cuisine, and availability
  • Monitor competitor ratings and average prices across markets
  • Feed hospitality analytics with geolocated dining data
  • Check real-time bookability and time slots for a given date and party size

Related APIs

Expand your data capabilities with these complementary tools.

View All
TheFork Restaurant/v2/thefork/restaurant

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.

GET2 credits = 1 requestActive

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
Start free (+500 credits)PiloterrTalk to a data expert