Saltar al contenido principal
Piloterr
Volver a la biblioteca

API de TheFork Search

Busque restaurantes TheFork por URL de búsqueda o ciudad: valoraciones, cocina, precios, disponibilidad y paginación. 2 créditos, navegador.

Activo2 créditos = 1 solicitudGET/v2/thefork/search

Resumen del Endpoint

Documentación detallada, precios y ejemplos de uso.

Descripción generalLink to Descripción general

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.

Inicio rápidoLink to Inicio rápido

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

Formatos URL soportadosLink to Formatos URL soportados

Formato Ejemplo
Búsqueda con filtros /search?cityId=529135&date=2026-06-13&hour=660&partySize=8
Listado ciudad /restaurants/strasbourg-c529135

ParámetrosLink to Parámetros

Parámetro Tipo Requerido Descripción
query string URL TheFork completa /search o /restaurants/

Respuesta (results[])Link to Respuesta (results[])

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

PaginaciónLink to Paginación

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

NotasLink to Notas

  • hour = minutos desde medianoche (660 = 11:00).
  • timeslots vacío sin filtro fecha/hora.

Flujo TheForkLink to Flujo TheFork

  1. TheFork Search (este endpoint) para descubrimiento de listings
  2. TheFork Restaurant para tags, galería, horarios, TripAdvisor

Casos de uso principalesLink to Casos de uso principales

  • 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

APIs relacionadas

Amplía tus capacidades de datos con estas herramientas complementarias.

¿Listo para empezar?

Tu API de web scraping está a un clic. Comienza con +500 créditos, sin infraestructura que configurar, sin proxies que gestionar y sin necesidad de tarjeta de crédito.

  • +500 créditos
  • Sin tarjeta de crédito
  • Todos los endpoints incluidos