Zum Hauptinhalt springen
Piloterr
Zurück zur Bibliothek

API TheFork Search

TheFork-Restaurants per Such- oder Stadt-URL suchen: Bewertungen, Küche, Preise, Verfügbarkeit und Paginierung. 2 Credits, Browser.

Aktiv2 Credits = 1 AnfrageGET/v2/thefork/search

Endpunkt-Übersicht

Detaillierte Dokumentation, Preise und Anwendungsbeispiele.

ÜberblickLink to Überblick

Die TheFork Search API extrahiert Restaurant-Listings von TheFork-Such- oder Stadtseiten. Übergeben Sie eine vollständige TheFork-URL (/search?... oder /restaurants/{city}-c{id}) und erhalten Sie strukturierte Karten mit Bewertungen, Küche, Durchschnittspreis, Adresse, Geo, Buchbarkeit, KI-Review-Zusammenfassungen und Paginierung als JSON.

TheFork ist eine Next.js-SPA. Piloterr nutzt Browser-Rendering. 2 Credits pro Aufruf. Nutzen Sie results[].url mit TheFork Restaurant für vollständige Profile.

SchnellstartLink to Schnellstart

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

Unterstützte URL-FormateLink to Unterstützte URL-Formate

Format Beispiel
Suche mit Filtern /search?cityId=529135&date=2026-06-13&hour=660&partySize=8
Stadt-Listing /restaurants/strasbourg-c529135

ParameterLink to Parameter

Parameter Typ Pflicht Beschreibung
query string ja Vollständige TheFork /search- oder /restaurants/-URL

Antwort (results[])Link to Antwort (results[])

Feld Typ Beschreibung
id / name / url / slug integer / string / string / string ID, Name, URL, Slug
rating / reviews_count number / integer TheFork-Score (0-10), Reviews
cuisine / avg_price / currency string / number / string Küche, Preis, Währung
address / geolocation string / object Adresse, Koordinaten
is_bookable / timeslots[] boolean / array Buchbar, verfügbare Slots
reviews_summary / review_snippets[] string / array KI-Zusammenfassung, Auszüge

PaginierungLink to Paginierung

Feld Typ Beschreibung
pagination.current / total_pages / total_count integer Aktuelle Seite, Gesamtseiten, Gesamt
pagination.next_url string Nächste Seite (#list25, #list50, ...)
pagination.has_next_page boolean Weitere Seite vorhanden

HinweiseLink to Hinweise

  • hour = Minuten ab Mitternacht (660 = 11:00).
  • timeslots leer ohne Datum/Uhrzeit-Filter.

Ablauf TheForkLink to Ablauf TheFork

  1. TheFork Search (dieser Endpunkt) für Listing-Entdeckung
  2. TheFork Restaurant für Tags, Galerie, Öffnungszeiten, TripAdvisor

HauptanwendungsfälleLink to Hauptanwendungsfälle

  • Restaurant-Lead-Listen nach Stadt, Küche und Verfügbarkeit aufbauen
  • Wettbewerber-Bewertungen und Durchschnittspreise über Märkte tracken
  • Hospitality-Analytics mit geolokalisierten Dining-Daten speisen
  • Echtzeit-Buchbarkeit und Timeslots für Datum und Gruppengröße prüfen

Verwandte APIs

Erweitern Sie Ihre Datenmöglichkeiten mit diesen ergänzenden Tools.

Bereit loszulegen?

Ihre Web-Scraping-API ist nur einen Klick entfernt. Starten Sie mit +500 Credits, ohne Infrastruktur einrichten zu müssen, ohne Proxys zu verwalten und ohne Kreditkarte.

  • +500 Credits
  • Keine Kreditkarte erforderlich
  • Alle Endpunkte enthalten