GET

TripAdvisor Search API

Search for hotels in any destination on TripAdvisor with advanced filtering options.

Overview

Location-Based Search

Search for hotels in a specific geographic area with optional date filters and sorting options.

The TripAdvisor Search endpoint allows you to find hotels in a specific location (city, region, or area) with optional filtering by dates, guest configuration, and various sorting options.

Endpoint URL

GET https://api.stayapi.com/v1/tripadvisor/search

Query Parameters

Parameter	Type	Required	Description
geo_id	integer	Required	TripAdvisor geographic area ID (e.g., 293916 for Bangkok)
check_in	string	Optional	Check-in date (YYYY-MM-DD)
check_out	string	Optional	Check-out date (YYYY-MM-DD)
adults	integer	Optional	Number of adult guests (1-8, default: 2)
rooms	integer	Optional	Number of rooms (1-4, default: 1)
children_ages	array	Optional	List of children ages (e.g., [5, 12])
currency	string	Optional	Currency code (default: "USD")
offset	integer	Optional	Pagination offset (default: 0)
limit	integer	Optional	Number of results (1-50, default: 30)
sort	string	Optional	Sort order (see options below)

Sort Options

Available sort orders:

BEST_VALUE

Best value for money (default)

TRAVELER_RANKED

Traveler ranking

PRICE_LOW_TO_HIGH

Lowest price first

PRICE_HIGH_TO_LOW

Highest price first

Finding Geographic IDs

Common Geo IDs

Bangkok: 293916, Phuket: 2400063, Rome: 187791, Paris: 187147, London: 186338, New York: 60763

Geographic IDs can be found in TripAdvisor destination URLs:


            https://www.tripadvisor.com/Tourism-g293916-Bangkok_Thailand.html

The geo ID is 293916 (the number after "g").

Response Data

Hotel Information

Hotel name and TripAdvisor location ID
Rating (out of 5) and review count
Price range (minimum and maximum per night)
GPS coordinates (latitude/longitude)
Property type (HOTEL, RESORT, etc.)
Address and neighborhood

Pagination

Use offset and limit in search_params to paginate
Available filters and sort options returned per request

Request

curl -X GET "https://api.stayapi.com/v1/tripadvisor/search?geo_id=293916&check_in=2026-04-18&check_out=2026-04-20&adults=2&rooms=1&limit=10" \
  -H "x-api-key: YOUR_API_KEY"

// Search for hotels in Bangkok
const params = new URLSearchParams({
  geo_id: "293916",
  check_in: "2026-04-18",
  check_out: "2026-04-20",
  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.hotels.length} hotels`);

data.hotels.forEach((hotel, index) => {
  console.log(`${index + 1}. ${hotel.name}`);
  console.log(`   Rating: ${hotel.rating}/5 (${hotel.review_count} reviews)`);
  if (hotel.price) {
    console.log(`   Price: $${hotel.price.minimum}-$${hotel.price.maximum}/night`);
  }
  console.log(`   Location ID: ${hotel.location_id}`);
});

import requests

url = "https://api.stayapi.com/v1/tripadvisor/search"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {
    "geo_id": 293916,  # Bangkok
    "check_in": "2026-04-18",
    "check_out": "2026-04-20",
    "adults": 2,
    "rooms": 1,
    "limit": 20,
    "sort": "BEST_VALUE",
    "currency": "USD"
}

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

print(f"Total hotels: {len(data['hotels'])}")

for i, hotel in enumerate(data["hotels"], 1):
    print(f"{i}. {hotel['name']}")
    print(f"   Rating: {hotel.get('rating', 'N/A')}/5 ({hotel.get('review_count', 0)} reviews)")

    if hotel.get("price"):
        print(f"   Price: ${hotel['price']['minimum']}-${hotel['price']['maximum']}/night")

    print(f"   Location ID: {hotel['location_id']}")
    print()

Response

{
  "success": true,
  "geo_id": 293916,
  "search_params": {
    "check_in": "2026-04-18",
    "check_out": "2026-04-20",
    "adults": 2,
    "rooms": 1,
    "children_ages": [],
    "currency": "USD",
    "offset": 0,
    "limit": 10,
    "sort": "BEST_VALUE"
  },
  "hotels": [
    {
      "location_id": 8950960,
      "name": "Hotel Clover Asoke",
      "url": "/HotelHighlight-g293916-d8950960-Reviews-...",
      "geo_location": {
        "latitude": 13.7412,
        "longitude": 100.5591
      },
      "rating": 4.5,
      "review_count": 2345,
      "price": {
        "minimum": 85,
        "maximum": 210
      },
      "property_type": "HOTEL",
      "address": "123 Sukhumvit Road",
      "neighborhood": "Asoke",
      "merchandising_labels": ["Travellers\' Choice"]
    }
  ],
  "filters": {},
  "sort_options": [],
  "message": "Successfully retrieved hotel search results",
  "retrieved_at": "2026-02-27T10:30:00Z"
}

{
  "type": "https://api.stayapi.com/errors/upstream-error",
  "title": "Upstream Error",
  "status": 502,
  "detail": "GraphQL error: DataFetchingException",
  "instance": "/v1/tripadvisor/search",
  "provider": "tripadvisor",
  "error_code": "UPSTREAM_ERROR",
  "correlation_id": "req_abcdef1234"
}