La API TheFork Search extrae listings de restaurantes de páginas de búsqueda o ciudad TheFork. Pase una URL TheFork completa (/search?... o /restaurants/{city}-c{id}) y reciba tarjetas estructuradas con valoraciones, cocina, precio medio, dirección, geo, reservabilidad, resúmenes IA de reseñas y paginación en JSON.
TheFork es una SPA Next.js. Piloterr usa renderizado en navegador. 2 créditos por llamada. Use results[].url con TheFork Restaurant para perfiles completos.
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
| Formato |
Ejemplo |
| Búsqueda con filtros |
/search?cityId=529135&date=2026-06-13&hour=660&partySize=8 |
| Listado ciudad |
/restaurants/strasbourg-c529135 |
| Parámetro |
Tipo |
Requerido |
Descripción |
query |
string |
sí |
URL TheFork completa /search o /restaurants/ |
| Campo |
Tipo |
Descripción |
id / name / url / slug |
integer / string / string / string |
ID, nombre, URL, slug |
rating / reviews_count |
number / integer |
Puntuación TheFork (0-10), reseñas |
cuisine / avg_price / currency |
string / number / string |
Cocina, precio, moneda |
address / geolocation |
string / object |
Dirección, coordenadas |
is_bookable / timeslots[] |
boolean / array |
Reservable, slots disponibles |
reviews_summary / review_snippets[] |
string / array |
Resumen IA, extractos |
| Campo |
Tipo |
Descripción |
pagination.current / total_pages / total_count |
integer |
Página actual, total páginas, total |
pagination.next_url |
string |
Página siguiente (#list25, #list50, ...) |
pagination.has_next_page |
boolean |
Hay página siguiente |
hour = minutos desde medianoche (660 = 11:00).
timeslots vacío sin filtro fecha/hora.
- TheFork Search (este endpoint) para descubrimiento de listings
- TheFork Restaurant para tags, galería, horarios, TripAdvisor
- Construir listas leads restaurante por ciudad, cocina y disponibilidad
- Seguir valoraciones competidor y precios medios entre mercados
- Alimentar analytics hostelería con datos dining geolocalizados
- Comprobar reservabilidad y timeslots en tiempo real para fecha y grupo