cli-web-airbnb

Search Airbnb stays by location, dates, and filters; get detailed listing information including reviews and availability calendars; autocomplete location names. Installed at: cli-web-airbnb.

Quick Start

# Search for stays — returns listings with id, name, price, rating
cli-web-airbnb search stays "London, UK" --json

# Get full details for a specific listing
cli-web-airbnb listings get 770993223449115417 --json

Always use --json when parsing output programmatically.

Commands

search stays LOCATION

Search for stays in a location. Returns paginated listings with price, rating, coordinates.

cli-web-airbnb search stays "Paris, France" --json
cli-web-airbnb search stays "New York, NY" --checkin 2024-06-01 --checkout 2024-06-05 --adults 2 --json
cli-web-airbnb search stays "Tokyo, Japan" --max-price 150 --room-type private_room --json
cli-web-airbnb search stays "Barcelona, Spain" --cursor "eyJ..." --json

Key options: --checkin DATE, --checkout DATE, --adults N, --children N, --infants N, --pets N, --min-price N, --max-price N, --room-type [entire_home|private_room|shared_room|hotel_room], --cursor TOKEN, --locale CODE, --currency CODE

Output fields: success, count, next_cursor, total_count, location_slug, listings[] (each: id, id_b64, name, url, rating, price, price_qualifier, latitude, longitude, badges)

listings get LISTING_ID

Get full details for a specific listing.

cli-web-airbnb listings get 770993223449115417 --json
cli-web-airbnb listings get 1603496841117193305 --checkin 2024-06-01 --checkout 2024-06-05 --json

Key options: --adults N, --checkin DATE, --checkout DATE, --locale CODE, --currency CODE

Output fields: id, id_b64, name, url, rating, review_count, host_name, description, amenities[], bedrooms, bathrooms, max_guests, price, price_qualifier, latitude, longitude, badges

listings reviews LISTING_ID

Get guest reviews for a listing (sorted by quality, recency, or rating).

cli-web-airbnb listings reviews 770993223449115417 --json
cli-web-airbnb listings reviews 770993223449115417 --sort RECENT --limit 10 --json

Key options: --limit N (default 24), --offset N (pagination), --sort [BEST_QUALITY|RECENT|RATING_DESC|RATING_ASC], --locale CODE, --currency CODE

Output fields: success, listing_id, total_count, count, reviews[] (each: id, rating, date, reviewer, reviewer_location, comment, host_response)

listings availability LISTING_ID

Get 12-month availability calendar for a listing.

cli-web-airbnb listings availability 770993223449115417 --json
cli-web-airbnb listings availability 770993223449115417 --month 6 --year 2026 --count 3 --json

Key options: --month N (1-12, default current), --year N (default current), --count N (months, default 12), --available-only, --locale CODE, --currency CODE

Output fields: success, listing_id, months[] (each: month, year, days[] (each: date, available, checkin, checkout, min_nights, max_nights, price))

autocomplete locations QUERY

Suggest locations matching a partial query string.

cli-web-airbnb autocomplete locations "New Yor" --json
cli-web-airbnb autocomplete locations "Lond" --num-results 10 --json

Key options: --num-results N (default: 5), --locale CODE, --currency CODE

Output fields: success, query, suggestions[] (each: query, place_id, display, acp_id)

Agent Patterns

# Find affordable stays and inspect the cheapest one
cli-web-airbnb search stays "Amsterdam, Netherlands" --max-price 100 --json | \
  python -c "import json,sys; d=json.load(sys.stdin); l=d['listings'][0]; print(l['id'], l['price'])"

# Search then get full details round-trip
ID=$(cli-web-airbnb search stays "London, UK" --json | python -c "import json,sys; print(json.load(sys.stdin)['listings'][0]['id'])")
cli-web-airbnb listings get $ID --json

# Paginate through results
CURSOR=$(cli-web-airbnb search stays "Rome, Italy" --json | python -c "import json,sys; print(json.load(sys.stdin)['next_cursor'])")
cli-web-airbnb search stays "Rome, Italy" --cursor "$CURSOR" --json

# Resolve partial location before searching
cli-web-airbnb autocomplete locations "Barce" --json

Notes

• Auth: No authentication required. Airbnb is a fully public no-auth site.
• Bot protection: Akamai/DataDome bypassed automatically with curl_cffi Chrome impersonation.
• Rate limiting: No explicit limit. If blocked, retry after a short delay.
• Listing IDs: Long integer strings (e.g. 1603496841117193305). Use id_b64 for Airbnb internal API.
• Pagination: Cursor-based. Use next_cursor value with --cursor for the next page.
• Read-only: Search and view only. Booking is not implemented.
• Installation: pip install -e airbnb/agent-harness