airbnb-search

# Airbnb Search

Search Airbnb listings from the command line. Returns prices, ratings, and direct booking links.

## Requirements

- Python 3.8+
- `requests` library (auto-installed via `uv run --with`)

## Quick Start

```bash
# Run directly (no install needed)
uv run --with requests scripts/airbnb-search.py "Steamboat Springs, CO" --checkin 2025-03-01 --checkout 2025-03-03

# JSON output
uv run --with requests scripts/airbnb-search.py "Denver, CO" --checkin 2025-06-01 --checkout 2025-06-05 --json
```

## Options

```
query                Search location (e.g., "Steamboat Springs, CO")
--checkin, -i DATE   Check-in date (YYYY-MM-DD)
--checkout, -o DATE  Check-out date (YYYY-MM-DD)
--min-price N        Minimum price filter
--max-price N        Maximum price filter
--min-bedrooms N     Minimum bedrooms filter
--limit N            Max results (default: 50)
--json               Output as JSON
--format FORMAT      table or json (default: table)
```

## Example Output

```
📍 Steamboat Springs, CO
📊 Found 300+ total listings

==========================================================================================
Cozy Mountain Cabin 🏆
  2BR/1BA | ⭐4.92 | 127 reviews
  💰 $407 total
  🔗 https://airbnb.com/rooms/12345678
```

## Notes

- Dates are required for accurate pricing
- Prices include cleaning fees in the total
- No user API key needed — uses Airbnb's public frontend API key (hardcoded, same key used by airbnb.com in the browser)
- May break if Airbnb changes their internal GraphQL API
- Be respectful of rate limits

## Links

- [PyPI](https://pypi.org/project/airbnb-search/)
- [GitHub](https://github.com/Olafs-World/airbnb-search)

![airbnb-search banner](https://raw.githubusercontent.com/Olafs-World/airbnb-search/main/banner.png)

# airbnb-search 🏠

[![CI](https://github.com/Olafs-World/airbnb-search/actions/workflows/ci.yml/badge.svg)](https://github.com/Olafs-World/airbnb-search/actions/workflows/ci.yml)
[![PyPI version](https://badge.fury.io/py/airbnb-search.svg)](https://pypi.org/project/airbnb-search/)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**Search Airbnb listings from the command line.** No user API key required (uses Airbnb's public frontend API key). No browser automation. Just fast, reliable results.

```bash
$ airbnb-search "Steamboat Springs, CO" --checkin 2026-02-27 --checkout 2026-03-01 --max-price 500

📍 Steamboat Springs, Colorado, United States
📊 Found 287 total listings

==========================================================================================
Cozy Cabin Near Slopes 🏆
  2BR/1BA | ⭐4.95 | 42 reviews
  💰 $380 total before taxes
  🔗 https://airbnb.com/rooms/12345

Mountain View Retreat
  3BR/2BA | ⭐4.88 | 156 reviews
  💰 $450 total before taxes
  🔗 https://airbnb.com/rooms/67890
```

## Installation

### Quick run (no install)

```bash
uvx airbnb-search "Steamboat Springs, CO" --checkin 2026-02-27 --checkout 2026-03-01
```

### Install as CLI tool

```bash
uv tool install airbnb-search
airbnb-search "Steamboat Springs, CO" --checkin 2026-02-27 --checkout 2026-03-01
```

### As an Agent Skill

```bash
npx skills add olafs-world/airbnb-search

# or with OpenClaw
clawhub install olafs-world/airbnb-search
```

### Add to a project

```bash
uv add airbnb-search
```

Or with pip:

```bash
pip install airbnb-search
```

## Quick Start

### Command Line

```bash
# Basic search
airbnb-search "Denver, CO"

# With dates and price filter
airbnb-search "Winter Park, CO" --checkin 2026-03-15 --c...