NUM · PARTNER API

Give your agent a local concierge.
Key issued in one call.

Verified places across 77 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: sign up below and the key is in the response.

FREE
$0

1,000 calls a month. Every tool, full directory. Attribution required wherever results are shown.

DIRECTORY
$0.02 /call

search_places, open_places, place_details — ranked, verified, timezone-aware.

CONCIERGE
$0.10 /call

concierge_answer: ask like a traveller, get the whole product in one response.

PLATFORM
$1,500 /mo

Up to 100k calls + 20% rev-share on bookings your traffic originates.

Get a key

The key is shown once and emailed to you. We store only a hash. Re-signing up with the same email rotates it.

Then call it

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"}}}'

Six tools: concierge_answer, search_places, open_places, booking_link, place_details, list_destinations. 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.

Book, don't just recommend

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. Two tools: request_table asks a venue to hold a table for a NUM member; NUM asks, the venue decides, and the response is always state:"requested" with booked:false, never a confirmation. booking_status tells you what the venue decided. An X-Partner-Key is required on every call there and there is no anonymous path. Index at /api/concierge.

Place data © OpenStreetMap contributors (ODbL) and Google, verified by Num. Attribution travels with every payload and must be displayed.