TopTable API Documentation

User-Agent: YourApp/1.0 (contact@example.com)

https://gettoptable.com/api/v1

curl "https://gettoptable.com/api/v1/search?city=toronto&cuisine=italian&limit=2" \
  -H "User-Agent: MyApp/1.0"

{
  "city": "toronto",
  "query": {
    "cuisine": "italian"
  },
  "results": [
    {
      "id": 10516,
      "rank": 1,
      "name": "Scaddabush Italian Kitchen & Bar Don Mills",
      "rating": 4.8,
      "review_count": 4294,
      "price": "$$",
      "cuisine": "Italian",
      "area": "Leaside",
      "address": "67 O'Neill Rd, Toronto, ON M3C 0H2, Canada",
      "coordinates": {
        "lat": 43.73378,
        "lng": -79.34455
      },
      "open_now": true,
      "url": "https://gettoptable.com/toronto/places/scaddabush-italian-kitchen-and-bar-don-mills"
    },
    {
      "id": 1087,
      "rank": 2,
      "name": "Edna + Vita",
      "rating": 4.8,
      "review_count": 1700,
      "price": null,
      "cuisine": "Italian",
      "area": "Downtown",
      "address": "77 Adelaide St W, Toronto, ON M5H 0E2, Canada",
      "coordinates": {
        "lat": 43.649384,
        "lng": -79.382509
      },
      "open_now": true,
      "url": "https://gettoptable.com/toronto/places/edna-vita"
    }
  ],
  "total": 367,
  "page": 1,
  "per_page": 2,
  "pages": 5
}

curl "https://gettoptable.com/api/v1/places/10516?city=toronto" \
  -H "User-Agent: MyApp/1.0"

{
  "id": 10516,
  "name": "Scaddabush Italian Kitchen & Bar Don Mills",
  "rating": 4.8,
  "review_count": 4294,
  "price": "$$",
  "cuisine": "Italian",
  "area": "Leaside",
  "address": "67 O'Neill Rd, Toronto, ON M3C 0H2, Canada",
  "coordinates": {
    "lat": 43.73378,
    "lng": -79.34455
  },
  "open_now": true,
  "hours": {
    "sunday": "11:00-22:00",
    "monday": "11:00-22:00",
    "tuesday": "11:00-22:00",
    "wednesday": "11:00-22:00",
    "thursday": "11:00-23:00",
    "friday": "11:00-23:00",
    "saturday": "11:00-23:00"
  },
  "top_dishes": ["pasta", "pizza", "mozzarella", "steak", "cheesecake"],
  "highlights": [
    "Great for Large Groups",
    "Romantic Atmosphere",
    "Family-Friendly",
    "Perfect for Special Occasions",
    "Business Meeting Spot"
  ],
  "photos": [
    "https://lh3.googleusercontent.com/..."
  ],
  "reservation_url": "https://www.opentable.ca/...",
  "menu_url": "https://scaddabush.com/menu/...",
  "url": "https://gettoptable.com/toronto/places/scaddabush-italian-kitchen-and-bar-don-mills"
}

curl "https://gettoptable.com/api/v1/cities" \
  -H "User-Agent: MyApp/1.0"

{
  "cities": [
    {
      "id": "tel-aviv",
      "name": "Tel Aviv",
      "country": "Israel",
      "timezone": "Asia/Jerusalem",
      "center": { "lat": 32.0853, "lng": 34.7818 },
      "place_count": 3394,
      "areas": [
        { "id": "florentin", "name": "Florentin" },
        { "id": "neve-tzedek", "name": "Neve Tzedek" },
        { "id": "rothschild", "name": "Rothschild / Lev HaIr" }
      ],
      "vibes": [
        "date_night", "groups", "work_outing", "brunch",
        "drinks", "coffee", "foodie", "family",
        "remote_work", "business_lunch"
      ]
    },
    {
      "id": "toronto",
      "name": "Toronto",
      "country": "Canada",
      "timezone": "America/Toronto",
      "center": { "lat": 43.6532, "lng": -79.3832 },
      "place_count": 9205,
      "areas": [
        { "id": "yorkville", "name": "Yorkville" },
        { "id": "queen-west", "name": "Queen West" },
        { "id": "kensington-market", "name": "Kensington Market" }
      ],
      "vibes": ["..."]
    },
    {
      "id": "new-york",
      "name": "New York",
      "country": "United States",
      "timezone": "America/New_York",
      "center": { "lat": 40.7128, "lng": -74.006 },
      "place_count": 12331,
      "areas": [],
      "vibes": ["..."]
    }
  ]
}

{
  "error": "INVALID_CITY",
  "message": "Required parameter 'city' must be one of: tel-aviv, toronto, new-york",
  "available_cities": ["tel-aviv", "toronto", "new-york"]
}

curl "https://gettoptable.com/api/v1/search?city=toronto&cuisine=italian&vibe=date_night" \
  -H "User-Agent: MyApp/1.0"

curl "https://gettoptable.com/api/v1/places/10516?city=toronto" \
  -H "User-Agent: MyApp/1.0"

const BASE_URL = "https://gettoptable.com/api/v1";

async function searchRestaurants(city, filters = {}) {
  const params = new URLSearchParams({ city, ...filters });
  const res = await fetch(`${BASE_URL}/search?${params}`, {
    headers: { "User-Agent": "MyApp/1.0" },
  });

  if (!res.ok) {
    const err = await res.json();
    throw new Error(err.message);
  }

  return res.json();
}

async function getRestaurant(city, id) {
  const res = await fetch(`${BASE_URL}/places/${id}?city=${city}`, {
    headers: { "User-Agent": "MyApp/1.0" },
  });

  if (!res.ok) {
    const err = await res.json();
    throw new Error(err.message);
  }

  return res.json();
}

// Example: Find brunch spots in Tel Aviv
const results = await searchRestaurants("tel-aviv", {
  vibe: "brunch",
  minRating: 4.5,
});

console.log(`Found ${results.total} brunch spots`);
for (const r of results.results) {
  console.log(`  ${r.rank}. ${r.name} (${r.rating}) - ${r.area}`);
}

import requests

BASE_URL = "https://gettoptable.com/api/v1"
HEADERS = {"User-Agent": "MyApp/1.0"}


def search_restaurants(city, **filters):
    params = {"city": city, **filters}
    resp = requests.get(f"{BASE_URL}/search", params=params, headers=HEADERS)
    resp.raise_for_status()
    return resp.json()


def get_restaurant(city, place_id):
    resp = requests.get(
        f"{BASE_URL}/places/{place_id}",
        params={"city": city},
        headers=HEADERS,
    )
    resp.raise_for_status()
    return resp.json()


# Example: Find the best sushi in New York
results = search_restaurants("new-york", dish="sushi", minRating=4.5)

print(f"Found {results['total']} sushi restaurants")
for r in results["results"]:
    print(f"  {r['rank']}. {r['name']} ({r['rating']}) - {r['area']}")

# Get details for the top result
if results["results"]:
    top = results["results"][0]
    detail = get_restaurant("new-york", top["id"])
    print(f"\nTop dishes: {', '.join(detail['top_dishes'])}")
    print(f"Highlights: {', '.join(detail['highlights'])}")

npx @toptable/mcp

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

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