---
title: ToolRouter — Tool Detail
description: Detailed documentation for a ToolRouter tool including skills, parameters, and examples.
url: https://toolrouter.com/tools/stays-search
---
# Stays Search

Search stays worldwide: Airbnb listings with photos, ratings, prices, and booking links, plus hotel rate comparison across Booking.com, Agoda, and Trip.com. Use search_stays for Airbnb and compare_hotel_rates for hotels.

- **Version:** 0.07
- **Categories:** data, productivity
- **Workflow:** search_destinations → search_stays → compare_hotel_rates

## Skills (3)

### Search Destinations (`search_destinations`)

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

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | City, region, or address to search (e.g. "Paris", "Bali", "Manhattan New York") |

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

**Examples:**

*Search for Paris:*

```json
{
  "query": "Paris"
}
```

*Search for a specific area:*

```json
{
  "query": "Shibuya Tokyo"
}
```

### Search Stays (`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.

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `location` | string | Yes | Location to search (e.g. "Barcelona, Spain", "Paris", "Gracia, Barcelona") |
| `checkin` | string | No | Check-in date in YYYY-MM-DD format |
| `checkout` | string | No | Check-out date in YYYY-MM-DD format |
| `adults` | number | No | Number of adult guests (default 1) [default: 1] |
| `children` | number | No | Number of children |
| `infants` | number | No | Number of infants |
| `pets` | number | No | Number of pets |
| `currency` | string | No | Currency code for prices (e.g. "USD", "EUR", "GBP") |
| `page` | number | No | Page number for pagination (default 1) [default: 1] |

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

**Examples:**

*Search stays in Barcelona for 2 adults:*

```json
{
  "location": "Barcelona, Spain",
  "checkin": "2026-04-15",
  "checkout": "2026-04-17",
  "adults": 2
}
```

*Search a specific neighborhood:*

```json
{
  "location": "Gracia, Barcelona, Spain",
  "checkin": "2026-06-01",
  "checkout": "2026-06-07"
}
```

### Compare Hotel Rates (`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").

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `hotel_key` | string | Yes | TripAdvisor hotel key (format: g{location}-d{property}, e.g. "g60763-d99762", "g187147-d197572"). Find this from TripAdvisor hotel URLs. |
| `check_in` | string | Yes | Check-in date in YYYY-MM-DD format |
| `check_out` | string | Yes | Check-out date in YYYY-MM-DD format |
| `currency` | string | No | Currency code for prices (e.g. "USD", "EUR", "GBP"). Defaults to USD. |
| `rooms` | number | No | Number of rooms (default 1) [default: 1] |
| `adults` | number | No | Number of adults per room (default 2) [default: 2] |

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

**Examples:**

*Compare rates for a Paris hotel:*

```json
{
  "hotel_key": "g187147-d197572",
  "check_in": "2026-04-15",
  "check_out": "2026-04-17"
}
```

*Compare rates in EUR with 2 rooms:*

```json
{
  "hotel_key": "g60763-d99762",
  "check_in": "2026-05-01",
  "check_out": "2026-05-05",
  "currency": "EUR",
  "rooms": 2
}
```

## Quick Start

```bash
# Via CLI
TOOLROUTER_API_KEY=tr_live_xxx npx -y toolrouter-mcp call stays-search search_destinations --query Paris

# Via REST API
curl -H "Authorization: Bearer tr_live_xxx" \
     -d '{"tool":"stays-search","skill":"search_destinations","input":{"query":"Paris"}}' \
     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.

---

## Get Started with ToolRouter

**Already connected?** Call any tool with `use_tool({ tool, skill, input })`. Browse tools with `discover` or visit https://toolrouter.com/llms-full.txt

**New to ToolRouter?** Connect with one command (no API key needed — auto-provisions on first use):

```bash
# MCP (Claude Code, Codex CLI)
claude mcp add toolrouter -- npx -y toolrouter-mcp

# MCP (Cursor, Windsurf, Cline, VS Code, Gemini CLI, Claude Desktop)
{"mcpServers":{"toolrouter":{"command":"npx","args":["-y","toolrouter-mcp"]}}}

# Claude Chat / Claude Cowork / Claude Mobile — add as a connector:
# Settings → Connectors → Add custom connector → URL: https://api.toolrouter.com/mcp

# ChatGPT — add as an app:
# Settings → Apps → Advanced settings → enable Developer mode → Create app → MCP Server URL: https://api.toolrouter.com/mcp

# CLI (works instantly, no restart needed)
npx -y toolrouter-mcp tools                    # browse all tools
npx -y toolrouter-mcp search "seo"             # search by keyword
npx -y toolrouter-mcp call seo analyze_page --url https://example.com
```

Free tools work immediately. For paid tools, visit https://toolrouter.com/claim to add credits.

All platforms: https://toolrouter.com/connect | Full catalog: https://toolrouter.com/llms-full.txt | Docs: https://toolrouter.com/docs