Hotel Search API for AI Agents

Hotel Search Capabilities

• Natural Language Queries: Search using descriptions instead of filters ("romantic hotels with spa", "family-friendly resorts near beach")
• Context Understanding: AI interprets intent - "quiet" vs "lively", "luxury" vs "budget", "business" vs "leisure"
• Proximity Analysis: Find hotels near landmarks, airports, attractions, or custom coordinates
• Multi-criteria Search: Combine location, amenities, style, and price range in one query
• AI Ranking: Results ordered by relevance to your specific request

Hotel Search Query Examples

Basic Hotel Search

GET /query?
  query=hotels in Manhattan&
  lat=40.7589&
  lon=-73.9851&
  radius=2000&
  rank=true&
  limit=20

Contextual Hotel Search

GET /query?
  query=boutique hotels with rooftop bars near Central Park&
  lat=40.7829&
  lon=-73.9654&
  rank=true&
  answer=true

Proximity-Based Search

GET /query?
  query=hotels near JFK airport within 5 miles&
  lat=40.6413&
  lon=-73.7781&
  radius=8000&
  rank=true

Hotel Search Use Cases

Advanced Hotel Queries

Hotels with Specific Amenities

// Find hotels with specific features
GET /query?
  query=hotels with gym and business center in downtown Seattle&
  lat=47.6062&
  lon=-122.3321&
  rank=true&
  answer=true

// Response includes AI summary:
{
  "answer": "Found 12 hotels in downtown Seattle with gym and business center facilities. Top options include Hyatt Regency Seattle (0.3 mi from city center) and The Westin Seattle (0.5 mi from Pike Place Market), both offering full fitness centers and executive business amenities.",
  "results": [...]
}

Budget-Conscious Search

// Find affordable options
GET /query?
  query=budget hotels under $100 near airport with shuttle service&
  lat=33.9416&
  lon=-118.4085&
  rank=true

Luxury Hotel Discovery

// Find premium accommodations
GET /query?
  query=luxury 5-star hotels with ocean view and spa in Miami Beach&
  lat=25.7907&
  lon=-80.1300&
  rank=true

Hotel Proximity Analysis

Calculate distances and travel times from hotels to key locations:

// Find hotel location first
GET /query?query=Marriott Marquis Times Square&lat=40.7589&lon=-73.9851

// Calculate distance to attraction
POST /relationship
{
  "start": {"lat": 40.7590, "lon": -73.9845},  // Hotel coordinates
  "end": {"lat": 40.7614, "lon": -73.9776},    // Central Park
  "include": ["distance", "travel_time", "direction", "description"]
}

// Response:
{
  "distance_km": 1.2,
  "distance_miles": 0.75,
  "travel_time_minutes": 15,
  "direction": "northeast",
  "description": "Central Park is 0.75 miles northeast of the hotel, about a 15-minute walk."
}

Multi-Location Hotel Search

Find hotels convenient to multiple destinations:

POST /context
{
  "location": {"lat": 40.7589, "lon": -73.9851},
  "radius": "1000m",
  "context": "Find hotels that are within walking distance of both Broadway theaters and Times Square restaurants"
}

// Returns hotels with contextual analysis of proximity to both areas

Hotel Search Response Data

Typical hotel search response includes:

{
  "results": [
    {
      "name": "The Plaza Hotel",
      "type": "hotel",
      "lat": 40.7644,
      "lon": -73.9742,
      "address": "768 5th Ave, New York, NY 10019",
      "distance_km": 0.8,
      "tags": {
        "tourism": "hotel",
        "stars": "5",
        "rooms": "282",
        "website": "theplazany.com"
      }
    }
  ],
  "answer": "The Plaza Hotel is a luxury 5-star hotel located on Fifth Avenue...",
  "total_results": 15,
  "query_timestamp": "2025-11-23T10:30:00Z"
}

Integration Examples

Python - Hotel Search

import requests

API_KEY = "your_api_key"
API_URL = "https://api.getcamino.ai/query"

params = {
    "query": "pet-friendly hotels near Golden Gate Bridge",
    "lat": 37.8199,
    "lon": -122.4783,
    "radius": 3000,
    "rank": True,
    "answer": True,
    "limit": 10
}

headers = {"X-API-Key": API_KEY}

response = requests.get(API_URL, params=params, headers=headers)
hotels = response.json()

print(f"Found {len(hotels['results'])} pet-friendly hotels")
for hotel in hotels['results']:
    print(f"- {hotel['name']} ({hotel['distance_km']}km away)")

JavaScript - Hotel Search with MCP

// Using MCP with Claude or ChatGPT
{
  "name": "camino_query",
  "arguments": {
    "query": "boutique hotels with rooftop pools in Los Angeles",
    "latitude": 34.0522,
    "longitude": -118.2437,
    "limit": 15,
    "rank": true,
    "generate_answer": true
  }
}

Best Practices for Hotel Search

• Provide coordinates: Always include lat/lon for accurate proximity-based results
• Use descriptive queries: "family-friendly resort with kids activities" works better than just "hotel"
• Enable ranking: Set rank=true to get AI-sorted results by relevance
• Request summaries: Use answer=true for human-readable descriptions
• Set appropriate radius: Urban areas: 1-2km, Suburban: 5-10km, Rural: 20+ km
• Combine with routes: Use /route endpoint to calculate hotel-to-destination travel times

Hotel Search Pricing