L'API TheFork Search extrait des listings restaurant depuis pages recherche ou ville TheFork. Passez une URL TheFork complète (/search?... ou /restaurants/{city}-c{id}) et recevez cartes structurées avec notes, cuisine, prix moyen, adresse, geo, réservabilité, résumés IA des avis et pagination en JSON.
TheFork est une SPA Next.js. Piloterr utilise le rendu navigateur. 2 crédits par appel. Utilisez results[].url avec TheFork Restaurant pour profils complets.
GET https://api.piloterr.com/v2/thefork/search?query=https://www.thefork.fr/search?cityId=529135&date=2026-06-13&hour=660&partySize=8
GET https://api.piloterr.com/v2/thefork/search?query=https://www.thefork.fr/restaurants/strasbourg-c529135
| Format |
Exemple |
| Recherche avec filtres |
/search?cityId=529135&date=2026-06-13&hour=660&partySize=8 |
| Listing ville |
/restaurants/strasbourg-c529135 |
| Paramètre |
Type |
Requis |
Description |
query |
string |
oui |
URL TheFork complète /search ou /restaurants/ |
| Champ |
Type |
Description |
id / name / url / slug |
integer / string / string / string |
ID, nom, URL, slug |
rating / reviews_count |
number / integer |
Score TheFork (0-10), avis |
cuisine / avg_price / currency |
string / number / string |
Cuisine, prix, devise |
address / geolocation |
string / object |
Adresse, coordonnées |
is_bookable / timeslots[] |
boolean / array |
Réservable, créneaux disponibles |
reviews_summary / review_snippets[] |
string / array |
Résumé IA, extraits |
| Champ |
Type |
Description |
pagination.current / total_pages / total_count |
integer |
Page actuelle, total pages, total |
pagination.next_url |
string |
Page suivante (#list25, #list50, ...) |
pagination.has_next_page |
boolean |
Page suivante existe |
hour = minutes depuis minuit (660 = 11h00).
timeslots vide sans filtre date/heure.
- TheFork Search (cet endpoint) pour découverte de listings
- TheFork Restaurant pour tags, galerie, horaires, TripAdvisor
- Construire listes leads restaurant par ville, cuisine et disponibilité
- Suivre notes concurrents et prix moyens entre marchés
- Alimenter analytics hôtellerie avec données dining géolocalisées
- Vérifier réservabilité et créneaux en direct pour date et taille groupe