Airbnb APIairbnb.com ↗

"""Walkthrough: Airbnb SDK — search listings, drill into details, read reviews & calendar."""
from parse_apis.airbnb_listings_api import Airbnb, PropertyType, ReviewSort, ListingNotFound

client = Airbnb()

# Search apartments in Paris — limit= caps total items fetched across pages.
for listing in client.listingsummaries.search(query="Paris, France", property_type=PropertyType.APARTMENT, adults=2, limit=5):
    print(listing.title, listing.rating, listing.price.total if listing.price else "N/A")

# Drill into the first result for full detail.
summary = client.listingsummaries.search(query="Tokyo", limit=1).first()
if summary:
    detail = summary.details()
    print(detail.listing_id, detail.description[:80] if detail.description else "")
    if detail.capacity:
        print(detail.capacity.guests, "guests,", detail.capacity.bedrooms, "bedrooms")
    if detail.host:
        print(detail.host.name, "superhost:", detail.host.is_superhost)

# Read recent reviews for a listing, sorted by relevance.
if summary:
    for review in client.listings.get(listing_id=summary.listing_id).reviews(sort=ReviewSort.MOST_RELEVANT, limit=3):
        print(review.localized_date, review.rating, review.comments[:80] if review.comments else "")

# Check availability calendar for the next 3 months.
if summary:
    for month in client.listings.get(listing_id=summary.listing_id).calendar(months_count=3, limit=3):
        available = sum(1 for d in month.days if d.available)
        print(f"{month.month}/{month.year}: {available} available days")

# Typed error handling — catch a not-found listing.
try:
    client.listings.get(listing_id="9999999999999")
except ListingNotFound as exc:
    print(f"Listing not found: {exc.listing_id}")

print("exercised: listingsummaries.search / summary.details / listing.reviews / listing.calendar / listings.get")