Stays Search — Hotels, Airbnb & vacation rentals

Tools / Stays Search

Search Destinations

Search for a destination by name to find matching cities, regions, and neighborhoods. Returns location names with Place IDs and country codes.

Returns: List of matching destinations with display names, Place IDs, and country codes

Parameters

query *stringCity, region, or address to search (e.g. "Paris", "Bali", "Manhattan New York")

Example

Search for Paris

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "stays-search",
  "skill": "search_destinations",
  "input": {
    "query": "Paris"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Search Stays

Search for available stays (Airbnb, vacation rentals, apartments, unique homes) in a destination. Returns listings with names, photos, ratings, prices, coordinates, and direct Airbnb booking links. Supports date filtering, guest counts, and pagination.

Returns: List of stays with names, photos, ratings, prices, coordinates, beds/bedrooms, and Airbnb booking URLs

Parameters

location *stringLocation to search (e.g. "Barcelona, Spain", "Paris", "Gracia, Barcelona")

checkinstringCheck-in date in YYYY-MM-DD format

checkoutstringCheck-out date in YYYY-MM-DD format

adultsnumberNumber of adult guests (default 1)

childrennumberNumber of children

infantsnumberNumber of infants

petsnumberNumber of pets

currencystringCurrency code for prices (e.g. "USD", "EUR", "GBP")

pagenumberPage number for pagination (default 1)

Example

Search stays in Barcelona for 2 adults

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "stays-search",
  "skill": "search_stays",
  "input": {
    "location": "Barcelona, Spain",
    "checkin": "2026-04-15",
    "checkout": "2026-04-17",
    "adults": 2
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Compare Hotel Rates

Compare hotel rates across Booking.com, Agoda, Trip.com, and hotel websites. Returns per-night and total costs sorted cheapest first. Requires a TripAdvisor hotel key (format: g{location}-d{property}, e.g. "g60763-d99762").

Returns: Rates from Booking.com, Agoda, Trip.com, and hotel websites with per-night and total stay costs sorted cheapest first, plus savings summary

Parameters

hotel_key *stringTripAdvisor hotel key (format: g{location}-d{property}, e.g. "g60763-d99762", "g187147-d197572"). Find this from TripAdvisor hotel URLs.

check_in *stringCheck-in date in YYYY-MM-DD format

check_out *stringCheck-out date in YYYY-MM-DD format

currencystringCurrency code for prices (e.g. "USD", "EUR", "GBP"). Defaults to USD.

roomsnumberNumber of rooms (default 1)

adultsnumberNumber of adults per room (default 2)

Example

Compare rates for a Paris hotel

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "stays-search",
  "skill": "compare_hotel_rates",
  "input": {
    "hotel_key": "g187147-d197572",
    "check_in": "2026-04-15",
    "check_out": "2026-04-17"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

v0.072026-03-24

Switched Airbnb API provider from airbnb-search to airbnb13 (3b-data) — previous provider returned null for all listing fields
search_stays now returns rich results: names, photos, ratings, coordinates, beds, prices, and direct Airbnb booking URLs
search_stays no longer requires a place_id — accepts location name directly (e.g. "Barcelona, Spain")
Removed skills that depended on broken API: get_stay_details, check_availability, get_price_details, get_checkout_price, get_reviews, search_experiences, get_experience_details, get_experience_dates, get_experience_reviews, get_languages, get_currencies
Simplified workflow: search_destinations → search_stays, or search_stays directly with a location name

v0.062026-03-22

Added compare_hotel_rates — compares hotel prices across Booking.com, Agoda, Trip.com, and hotel websites
Tool now covers both Airbnb listings and traditional hotels from multiple booking providers
Updated description and instructions to guide agents to the right path (Airbnb vs hotel)

v0.052026-03-22

Renamed from hotel-search to stays-search — now covers hotels, Airbnb, vacation rentals, and experiences
Switched to Airbnb Search API for comprehensive global coverage
Added 13 skills: search_destinations, search_stays, get_stay_details, check_availability, get_price_details, get_checkout_price, get_reviews, search_experiences, get_experience_details, get_experience_dates, get_experience_reviews, get_languages, get_currencies
Search supports filters: price range, beds, bathrooms, property type, amenities, guest favorite
Full property details: descriptions, amenities, photos, ratings, host info, policies
Availability calendar with date-level booking status and min/max night requirements
Guest reviews with ratings, category breakdowns, and host responses
Local experiences: search tours and activities, check dates and reviews

v0.042026-03-22

Added subtitle, expanded description, and agent instructions

v0.032026-03-20

Fixed price labels and added total stay cost calculations

v0.022026-03-20

Improved error handling and hotel_key format validation

v0.012026-03-20

Initial release as hotel-search with hotel search, rate comparison, and price calendar

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"stays-search","skill":"search_destinations","input":{}}' \
  https://api.toolrouter.com/v1/tools/call

Frequently Asked Questions

Can I search stays by city name without a Place ID?

Yes. `search_stays` accepts a location name directly, so you can search places like Barcelona, Spain or a neighborhood without looking up a Place ID first. Use `search_destinations` only when you want help finding the best match.

What details do stay results include?

Results include names, photos, ratings, prices, coordinates, beds or bedrooms, and a direct Airbnb booking link. The listing view is built for comparing options quickly, not just finding the cheapest result.

Can I compare hotel prices too?

Yes. `compare_hotel_rates` compares live prices from Booking.com, Agoda, Trip.com, and hotel websites using a TripAdvisor hotel key. It sorts the cheapest options first and shows per-night and total stay cost.

Can I filter by dates, guests, and currency?

Yes. `search_stays` supports check-in and check-out dates in `YYYY-MM-DD`, plus adults, children, infants, pets, currency, and page number. Hotel comparisons also let you set rooms and adults per room.