# TopTable

> Restaurant discovery powered by AI analysis of millions of Google reviews

## About

TopTable analyzes Google reviews using AI to extract 127 features across 20 categories for every restaurant. Find the best restaurants for any occasion, cuisine, dish, or vibe.

## Cities

- [Toronto](https://gettoptable.com/toronto): 9,200+ restaurants
- [Tel Aviv](https://gettoptable.com/tel-aviv): 3,400+ restaurants
- [New York](https://gettoptable.com/new-york): 12,300+ restaurants

## What You Can Search

- Specific dishes: "best sushi", "best poutine", "best shawarma"
- Cuisines: Italian, Japanese, Mexican, Middle Eastern, and 350+ more
- Vibes & occasions: date night, group dining, solo dining, brunch, late night
- Features: outdoor seating, cozy atmosphere, good for working, kid-friendly
- Neighborhoods: search within specific areas of each city

## URL Patterns

- City page: `https://gettoptable.com/{city}`
- Dish/cuisine/feature: `https://gettoptable.com/{city}/best-{slug}`
- Neighborhood: `https://gettoptable.com/{city}/{area-slug}`
- Restaurant: `https://gettoptable.com/{city}/restaurant/{restaurant-slug}`

## Public API

TopTable provides a free REST API for restaurant search. No API key required — just include a User-Agent header.

- Base URL: `https://gettoptable.com/api/v1`
- Rate limit: 5 requests/minute per IP
- Auth: User-Agent header required (no API key)
- [API Documentation](https://gettoptable.com/docs)

### Endpoints

- `GET /api/v1/search` — Search and filter restaurants by city, cuisine, vibe, dish, neighborhood, price, and more. Returns paginated results (max 20/page, 5 pages).
- `GET /api/v1/places/:id?city={city}` — Get detailed restaurant info including hours, top dishes, highlights, photos, and reservation/menu links.
- `GET /api/v1/cities` — List available cities with neighborhoods, coordinates, and supported vibes.

### MCP Server

An MCP server is available for direct AI assistant integration:

```json
{
  "mcpServers": {
    "toptable": {
      "command": "npx",
      "args": ["@toptable/mcp"]
    }
  }
}
```

## Links

- [Homepage](https://gettoptable.com)
- [API Documentation](https://gettoptable.com/docs)
- [Search Toronto](https://gettoptable.com/toronto)
- [Search Tel Aviv](https://gettoptable.com/tel-aviv)
- [Search New York](https://gettoptable.com/new-york)