Real, mapped places across 119 destinations, live open-now status, booking links with the party size already filled in, and full concierge answers — over plain HTTPS or MCP. No sales call, no waitlist: the key is in the response.
10,000 calls a month, no monthly fee. Directory, place details, menus, the reviews summary and booking links are all free within it. Attribution required wherever results are shown.
Past the free allowance: search_places, open_places, place_details, directory_feed, get_menu, get_reviews — ranked, checked, timezone-aware.
concierge_answer: ask like a traveler, get the whole product in one response.
Up to 1,000,000 calls a month + 10% rev-share on bookings your traffic originates.
OpenTable's Booking API is $8,000/month and its Reviews API $3,335/month. NUM's directory, menus, reviews summary and booking requests have no monthly fee.
curl -X POST https://app.itsnum.com/api/partner/mcp \
-H "Content-Type: application/json" \
-H "X-Partner-Key: YOUR_KEY" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
"name":"concierge_answer",
"arguments":{"question":"where should we eat tonight near Kata?","destination":"phuket"}}}'
Nine tools: concierge_answer, search_places, open_places, booking_link, place_details, list_destinations, directory_feed (the whole directory for a destination, paged), get_menu (the venue's own published menu and prices) and get_reviews (a rating summary — public rating plus NUM's verified-guest average and star split; never review text or reviewer names). Human-readable index at /api/partner · usage at /api/partner/usage with your key header. Booking links are prefilled hand-offs, never claimed reservations — the response always says booked:false until a real reservation API stands behind it.
Unkeyed traffic on this read-only surface is limited to 12 tools/call a minute per IP and is unattributed; discovery (initialize, tools/list) is never throttled. Send a key for an attributed monthly quota.
The directory above is read-only and open: no key, no bookings, no personal data, ever. Confirmed bookings live on a separate keyed surface, https://app.itsnum.com/api/concierge/mcp — a tool that can make a real restaurant's phone ring should not share an access policy with one that reads opening hours. Seven tools, the whole booking lifecycle: check_availability (is the place open then, and how NUM will ask it), request_table (for a NUM member, or for your own guest by name alone — NUM never contacts your guest; NUM asks, the venue decides, and the response is booked:false until the venue says yes), booking_status (your bookings only, with their timeline), modify_booking, cancel_booking, set_webhook (every change POSTed to your server, signed with Num-Signature) and webhook_status. The guest never pays a card hold, a deposit or a no-show fee. An X-Partner-Key is required on every call there and there is no anonymous path; booking requests are switched on for a key after a short check, because they make real venues' phones ring. Index at /api/concierge.
| OpenTable | Their price | NUM |
|---|---|---|
| Directory API | Partner agreement | directory_feed, search_places — free, instant key, every kind of place |
| Restaurant Content (profile) | Free, after approval | place_details — free, no approval |
| Menu Data API | Free, after approval | get_menu — the venue's own published menu, free |
| Booking Partner: availability, slot lock, book, read, modify, cancel | $8,000/month | check_availability, request_table, booking_status, modify_booking, cancel_booking — no monthly fee |
| Reservation webhook | Separate sync tier | set_webhook — included, signed, retried |
| Reviews API (read + reply) | $3,335/month | get_reviews rating summary from verified guests — free (replies are not offered yet) |
What NUM does not pretend: it holds no live table inventory, so it never claims a table is free before the venue says so.
Place data © OpenStreetMap contributors (ODbL) and Google, checked by NUM. Attribution travels with every payload and must be displayed.