Ir para o conteúdo principal
Status da rede
Entrar
Piloterr
Voltar à biblioteca

API TheFork Search

Pesquise restaurantes TheFork por URL de pesquisa ou cidade: avaliações, cozinha, preços, disponibilidade e paginação. 2 créditos, navegador.

Ativo2 créditos = 1 requisiçãoGET/v2/thefork/search
Experimente o endpoint grátisPiloterr

Visão Geral do Endpoint

Documentação detalhada, preços e exemplos de uso.

Visão geralLink to Visão geral

A API TheFork Search extrai listings de restaurantes de páginas de pesquisa ou cidade TheFork. Passe uma URL TheFork completa (/search?... ou /restaurants/{city}-c{id}) e receba cartões estruturados com avaliações, cozinha, preço médio, morada, geo, reservabilidade, resumos IA de reviews e paginação em JSON.

O TheFork é uma SPA Next.js. A Piloterr usa renderização no navegador. 2 créditos por chamada. Use results[].url com TheFork Restaurant para perfis completos.

Início rápidoLink to Início 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 suportadosLink to Formatos URL suportados

Formato Exemplo
Pesquisa com filtros /search?cityId=529135&date=2026-06-13&hour=660&partySize=8
Listagem cidade /restaurants/strasbourg-c529135

ParâmetrosLink to Parâmetros

Parâmetro Tipo Obrigatório Descrição
query string sim URL TheFork completa /search ou /restaurants/

Resposta (results[])Link to Resposta (results[])

Campo Tipo Descrição
id / name / url / slug integer / string / string / string ID, nome, URL, slug
rating / reviews_count number / integer Pontuação TheFork (0-10), reviews
cuisine / avg_price / currency string / number / string Cozinha, preço, moeda
address / geolocation string / object Morada, coordenadas
is_bookable / timeslots[] boolean / array Reservável, slots disponíveis
reviews_summary / review_snippets[] string / array Resumo IA, extractos

PaginaçãoLink to Paginação

Campo Tipo Descrição
pagination.current / total_pages / total_count integer Página atual, total páginas, total
pagination.next_url string Página seguinte (#list25, #list50, ...)
pagination.has_next_page boolean Existe página seguinte

NotasLink to Notas

  • hour = minutos desde meia-noite (660 = 11:00).
  • timeslots vazio sem filtro data/hora.

Fluxo TheForkLink to Fluxo TheFork

  1. TheFork Search (este endpoint) para descoberta de listings
  2. TheFork Restaurant para tags, galeria, horários, TripAdvisor

Casos de uso principaisLink to Casos de uso principais

  • Construir listas leads restaurante por cidade, cozinha e disponibilidade
  • Acompanhar avaliações concorrentes e preços médios entre mercados
  • Alimentar analytics hotelaria com dados dining geolocalizados
  • Verificar reservabilidade e timeslots em tempo real para data e tamanho grupo

APIs Relacionadas

Expanda suas capacidades de dados com essas ferramentas complementares.

Ver Todos
TheFork Restaurant/v2/thefork/restaurant

Obtenha perfil restaurante TheFork por URL: avaliações, cozinha, preço, fotos, horários e resumo IA de reviews. 2 créditos, navegador.

GET2 créditos = 1 requisiçãoAtivo

Pronto para começar?

Sua API de web scraping está a um clique. Comece com +500 créditos, sem infraestrutura para configurar, sem proxies para gerenciar e sem cartão de crédito necessário.

  • +500 créditos
  • Sem cartão de crédito
  • Todos os endpoints incluídos
Comece grátis (+500 créditos)PiloterrFale com um especialista em dados