sevenrooms.com APIwww.sevenrooms.com ↗
Search available tables, check open dates, and complete reservations at any SevenRooms venue. 5 endpoints covering venue info, availability, holds, and bookings.
curl -X GET 'https://api.parse.bot/scraper/ad4bb394-079b-49ce-9c1b-bcc748b5ac37/get_venue_info?venue_slug=noburestaurant' \ -H 'X-API-Key: $PARSE_API_KEY'
Get venue details including name, address, timezone, currency, and linked venues for any SevenRooms restaurant.
| Param | Type | Description |
|---|---|---|
| venue_slugrequired | string | The venue's URL key/slug (e.g., 'noburestaurant'). Found in the SevenRooms reservation URL. |
{
"type": "object",
"fields": {
"city": "string, city where venue is located",
"name": "string, venue display name",
"address": "string, full street address",
"url_key": "string, venue URL slug",
"currency": "string, three-letter currency code (e.g. 'GBP')",
"timezone": "string, IANA timezone (e.g. 'Europe/London')",
"venue_id": "string, unique venue identifier",
"country_code": "string, two-letter country code (e.g. 'gb')",
"phone_number": "string or null, venue phone number",
"linked_venues": "array of URL slugs for linked venues"
},
"sample": {
"data": {
"city": "London",
"name": "Wild Tavern Chelsea",
"address": "123 Main St, Springfield, IL 62704",
"url_key": "wildtavernchelsea",
"currency": "GBP",
"timezone": "Europe/London",
"venue_id": "ahNzfnNldmVucm9vbXMtc2VjdXJlchwLEg9uaWdodGxvb3BfVmVudWUYgICE94rM0AkM",
"country_code": "gb",
"phone_number": "+1 (555) 012-3456",
"linked_venues": []
},
"status": "success"
}
}About the sevenrooms.com API
The SevenRooms API covers 5 endpoints for searching and booking restaurant reservations at any venue on the SevenRooms platform. Starting with get_venue_info, you can retrieve venue name, address, timezone, currency, and linked venues by slug. From there, search_availability returns shift-level time slots with booking IDs, and create_reservation completes the full booking cycle with a confirmed reservation ID.
Venue Discovery and Date Availability
The get_venue_info endpoint accepts a venue_slug — the URL key found in any SevenRooms reservation URL — and returns core venue data: name, address, city, timezone (IANA format), currency (three-letter code), venue_id, country_code, phone_number, and a linked_venues array of related venue slugs. The get_available_dates endpoint takes the same slug plus an optional start_date (YYYY-MM-DD) and num_days count, returning a flat valid_dates array and a total_dates count. The window covers up to 225 days from the start date.
Searching and Holding Time Slots
search_availability accepts venue_slug, date, party_size, time_slot (HH:MM for centering results), and num_days. It returns a shifts array where each shift carries a shift_name, shift_persistent_id, and a time_slots array. Each time slot includes the access_persistent_id and shift_persistent_id values required by the next step. The total_slots field gives a quick count across all shifts.
Before confirming, hold_reservation locks a specific slot for 300 seconds (hold_duration_sec). It requires date, time, party_size, venue_slug, shift_persistent_id, and access_persistent_id — all sourced directly from search_availability output. It returns a reservation_hold_id that must be passed to create_reservation.
Completing a Reservation
create_reservation finalizes the booking within the 5-minute hold window. Required inputs are reservation_hold_id, venue_id, date, time, first_name, last_name, and a valid email address (non-example.com domains only). Optional fields include notes for special requests and dial_code for phone formatting. On success it returns a reservation_id and a confirmation_number (or null if the venue does not supply one).
- Build a restaurant booking app that checks real-time slot availability by party size and preferred time using search_availability
- Aggregate open reservation dates across multiple linked venues using get_available_dates and linked_venues from get_venue_info
- Automate table reservations for concierge or travel planning services using the full hold-then-confirm flow
- Display venue timezone, address, and currency for multi-country dining guides using get_venue_info fields
- Alert users to newly opened reservation slots by polling get_available_dates for a target date range
- Pre-fill booking forms with venue currency and phone dial code pulled from get_venue_info before calling create_reservation
| 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.