# Weavify - Bangkok F&B Agent Gateway
> API for AI agents to discover and book restaurants, bars, and nightclubs in Bangkok.

## Authentication
No authentication required. All endpoints are open for AI agents.
Optional: pass an X-API-Key header for higher rate limits (30 RPM anonymous, 120 RPM with key).

## Base URL
https://weavify.io/api/v1

## What you can do

### Search for venues
GET /api/v1/search/venues?lat=13.7563&lon=100.5018&radius_km=2&venue_type=bar_or_pub
Returns venues near a location with distance, sorted by proximity. No auth required.

### Read venue details
GET /api/v1/venues/{slug}/md
Returns a complete venue profile in plain Markdown: name, address, menu, availability, booking instructions.

GET /api/v1/venues/{slug}/jsonld
Returns Schema.org structured data (Restaurant, BarOrPub, or NightClub).

### Check availability
GET /api/v1/search/availability?venue_id={id}&date=2026-04-10&party_size=4
Returns available time slots and table types. No auth required.

### Book a table (no auth required)
1. POST /api/v1/bookings/hold — creates a 10-minute temporary hold
   Body: {"venue_id": "...", "date": "YYYY-MM-DD", "party_size": 4, "guest_name": "...", "block_type": "standard_table"}
2. POST /api/v1/bookings/holds/{hold_id}/confirm — finalizes the booking
   Returns a confirmation code (e.g. WV-A3K9X2)

### Cancel a booking
PATCH /api/v1/bookings/{booking_id}/cancel

## Venue types
- restaurant: Sit-down dining
- bar_or_pub: Bars, pubs, craft cocktail spots
- night_club: Nightclubs, lounges with bottle service

## Table types
- standard_table: Regular dining/drinking table
- vip_booth: VIP booth, often with bottle service
- bar_seat: Bar seating

## Bangkok districts covered
Sukhumvit, Silom, Sathorn, Rattanakosin, Thonglor, Ekkamai, Ari, Riverside

## Browse all venues
GET /api/v1/discovery/sitemap