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.
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 |
Beispiel |
| Suche mit Filtern |
/search?cityId=529135&date=2026-06-13&hour=660&partySize=8 |
| Stadt-Listing |
/restaurants/strasbourg-c529135 |
| Parameter |
Typ |
Pflicht |
Beschreibung |
query |
string |
ja |
Vollständige TheFork /search- oder /restaurants/-URL |
| 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 |
| 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 |
hour = Minuten ab Mitternacht (660 = 11:00).timeslots leer ohne Datum/Uhrzeit-Filter.
- TheFork Search (dieser Endpunkt) für Listing-Entdeckung
- TheFork Restaurant für Tags, Galerie, Öffnungszeiten, TripAdvisor
- 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
