Aller au contenu principal
Piloterr
Retour à la bibliothèque

API TheFork Search

Recherchez restaurants TheFork par URL recherche ou ville : notes, cuisine, prix, disponibilité et pagination. 2 crédits, navigateur.

Actif2 crédits = 1 requêteGET/v2/thefork/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

Vue d'ensembleLink to Vue d'ensemble

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.

Démarrage rapideLink to Démarrage rapide

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

Formats URL supportésLink to Formats URL supportés

Format Exemple
Recherche avec filtres /search?cityId=529135&date=2026-06-13&hour=660&partySize=8
Listing ville /restaurants/strasbourg-c529135

ParamètresLink to Paramètres

Paramètre Type Requis Description
query string oui URL TheFork complète /search ou /restaurants/

Réponse (results[])Link to Réponse (results[])

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

PaginationLink to Pagination

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

NotesLink to Notes

  • hour = minutes depuis minuit (660 = 11h00).
  • timeslots vide sans filtre date/heure.

Processus TheForkLink to Processus TheFork

  1. TheFork Search (cet endpoint) pour découverte de listings
  2. TheFork Restaurant pour tags, galerie, horaires, TripAdvisor

Cas d'utilisation principauxLink to Cas d'utilisation principaux

  • 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

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus