# tobook LLM API

> Clean REST API optimized for LLM agents and autonomous systems. Search hotels, get real-time offers, and create bookings.

## Base URL
https://llm.tobook.com

## Main Endpoints

### Countries
`GET /countries?langID=1`  
List all available countries.

### Find Location
`GET /findLocation?fragment=amster&langID=1`  
Search locations by partial name.

### Hotels
`GET /hotels?searchLocationId=1505&arr=2026/07/21&dep=2026/07/22&numAdults=2&langID=1`  
Search hotels in a location with availability.

### Hotel Details
`GET /hotel?hotelId=100093&arr=2026/07/21&dep=2026/07/22&numAdults=2&langID=1`  
Get rich details for a specific hotel (offers, facilities, policies, photos, reviews).

### Offers
`GET /offers?hotel_id=100&arr=07/07/2026&dep=07/08/2026&numAdults=2&langID=1`  
Get real-time room rates and availability.

### Bookings
`POST /bookings`  
Create a booking inquiry (non-binding). Requires guest details.

## Quick Start for Agents

1. Call `/countries`
2. Call `/findLocation?fragment=...`
3. Call `/hotels?...`
4. Call `/offers?...`
5. Call `/bookings` with selected offer data

## Documentation
Full documentation: https://www.tobook.com/Developers/APIDocs/OTALLM

## Rate Limits
- Default: 30 requests per minute
- Please implement exponential backoff on 429 responses.

Last updated: July 2026