toasttab.com APItoasttab.com ↗
Search Toast restaurants by location, retrieve full profiles with hours and contact info, and fetch complete menus with item names, descriptions, and prices.
curl -X GET 'https://api.parse.bot/scraper/fa87477a-6532-42f5-b8b8-57ccbe16894e/search_restaurants?query=Italian&latitude=40.758896&longitude=-73.985130' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for restaurants by geographic coordinates and optional query string. Returns up to 20 nearby restaurants with basic info including name, cuisine, slug, and location.
| Param | Type | Description |
|---|---|---|
| query | string | Optional keyword to filter restaurants by name or cuisine |
| latituderequired | number | Latitude of the search center |
| longituderequired | number | Longitude of the search center |
{
"type": "object",
"fields": {
"restaurants": "array of restaurant objects with name, guid, slug, cuisine, image, and location"
},
"sample": {
"data": {
"restaurants": [
{
"guid": "f587b8a4-0a74-4b4e-acee-65618954bb70",
"name": "Trattoria Trecolori 254 West 47th Street",
"slug": "trattoria-trecolori-em-254-west-47th-street",
"image": "/restaurants/restaurant-243799000000000000/restaurant_list_image_1738426666.jpg",
"cuisine": "Italian",
"location": {
"latitude": 40.759869,
"longitude": -73.986766
}
}
]
},
"status": "success"
}
}About the toasttab.com API
This API provides 3 endpoints for accessing restaurant and menu data from ToastTab.com. Use search_restaurants to find nearby restaurants by latitude/longitude with optional keyword filtering, get_restaurant_details to pull a full restaurant profile including address, phone, schedule, and cuisine type, and get_menu_items to retrieve structured menus with category groupings, item names, descriptions, and prices.
Search and Discovery
The search_restaurants endpoint accepts a latitude and longitude (both required) plus an optional query string to filter by name or cuisine. It returns up to 20 results per call, each including a name, guid, slug, cuisineType, image, and location object. The slug and guid returned here feed directly into the other two endpoints.
Restaurant Details
get_restaurant_details takes a restaurant slug (for example, the-lost-whale) and returns a full profile: guid, name, cuisineType, a description string, and a location object with address1, city, state, zip, phone, latitude, and longitude. It also returns a schedule object containing upcoming daily schedules and service periods, making it useful for determining current operating hours.
Menu Data
get_menu_items accepts either a guid or a slug — at least one must be provided. The response includes a menus array structured into category groups, each containing items with names, descriptions, and prices. The groupings array enumerates menu sections with item counts, and both count and totalCount fields give item totals. This makes it straightforward to reconstruct a full, categorized menu view for any Toast-powered restaurant.
- Build a local restaurant discovery app using latitude/longitude search and cuisine filtering
- Aggregate and compare menu prices across multiple restaurants in a given area
- Display current operating hours for Toast-powered restaurants using the
schedulefield - Create a menu-embedding integration for food ordering or reservation tools
- Populate a restaurant directory with addresses, phone numbers, and cuisine categories
- Monitor menu changes over time by periodically fetching
get_menu_itemsfor tracked restaurants - Enrich a mapping application with nearby restaurant pins using returned location coordinates
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Toast have an official public developer API?+
What does `get_menu_items` return, and how is it structured?+
menus array where each menu contains groups of items. Each item includes its name, description, and price. The groupings array lists category sections with item counts, and totalCount gives the aggregate item count across all menus. You can look up by either guid or slug; at least one must be supplied.