TripAdvisor Search API

// Search for hotels in Phuket
const params = new URLSearchParams({
  geo_id: "2400063", // Phuket
  check_in: "2025-08-01",
  check_out: "2025-08-05",
  adults: "2",
  rooms: "1",
  limit: "20",
  sort: "BEST_VALUE"
});

const response = await fetch(
  `https://api.stayapi.com/v1/tripadvisor/search?${params}`,
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();

console.log(`Found ${data.data.total_results} hotels in ${data.data.geo_name}`);

// Display results
data.data.hotels.forEach((hotel, index) => {
  console.log(`\n${index + 1}. ${hotel.name}`);
  console.log(`   Rating: ${hotel.rating}/5 (${hotel.num_reviews} reviews)`);
  console.log(`   Ranking: #${hotel.ranking}`);
  if (hotel.price_level) {
    console.log(`   Price: ${hotel.price_level}`);
  }
  if (hotel.distance) {
    console.log(`   Distance: ${hotel.distance} from center`);
  }
});

// Show available filters
console.log("\nAvailable Filters:");
Object.entries(data.data.filters).forEach(([filterType, options]) => {
  console.log(`  ${filterType}: ${options.length} options`);
});

import requests

# Search parameters
geo_id = "2400063"  # Phuket, Thailand
url = "https://api.stayapi.com/v1/tripadvisor/search"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {
    "geo_id": geo_id,
    "check_in": "2025-08-01",
    "check_out": "2025-08-05",
    "adults": 2,
    "rooms": 1,
    "limit": 20,
    "sort": "BEST_VALUE",
    "currency": "USD"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

# Display search summary
print(f"Search Results for {data['data']['geo_name']}")
print(f"Total hotels found: {data['data']['total_results']}")
print(f"Showing: {len(data['data']['hotels'])} results\n")

# Display hotels
for i, hotel in enumerate(data["data"]["hotels"], 1):
    print(f"{i}. {hotel['name']}")
    print(f"   Location ID: {hotel['location_id']}")
    print(f"   Rating: {hotel['rating']}/5 ({hotel['num_reviews']} reviews)")
    print(f"   Ranking: #{hotel['ranking']} in {data['data']['geo_name']}")
    
    if hotel.get("price_level"):
        print(f"   Price Level: {hotel['price_level']}")
    
    if hotel.get("price_per_night"):
        print(f"   Price: {hotel['price_per_night']} per night")
    
    if hotel.get("subcategory"):
        print(f"   Type: {hotel['subcategory']}")
    
    print(f"   Distance: {hotel.get('distance', 'N/A')}")
    print()

# Show filter options
if "filters" in data["data"]:
    print("\nAvailable Filters:")
    for filter_type, options in data["data"]["filters"].items():
        print(f"\n{filter_type}:")
        for opt in options[:5]:  # Show first 5 options
            count = opt.get("count", "")
            print(f"  - {opt['name']} ({count} hotels)" if count else f"  - {opt['name']}")
        if len(options) > 5:
            print(f"  ... and {len(options) - 5} more")

# Pagination info
if data["data"]["hotels"]:
    print(f"\nPagination:")
    print(f"  Current offset: {params.get('offset', 0)}")
    print(f"  Results per page: {params['limit']}")
    print(f"  Has more results: {len(data['data']['hotels']) == params['limit']}")

{
  "error": "Invalid geo_id",
  "detail": "The provided geo_id is not valid",
  "status_code": 400
}