Does Airbnb have a public API? Listings and calendars

export TOOLZERHUB_API_KEY=your_key
curl -G -H "x-api-key: $TOOLZERHUB_API_KEY" \
  --data-urlencode "destination=Kyoto, Japan" -d count=10 \
  "https://api.toolzerhub.com/v1/airbnb/stays/search"

{
  "id": "1744088620623845596",
  "url": "https://www.airbnb.com/rooms/1744088620623845596",
  "name": "LuckyaKotako|Shijo&Nishiki|Shigaraki Open-Air Bath",
  "title": "Townhouse in Kyoto",
  "subtitle": "112 m² machiya with a private Japanese garden and a semi-open-air Shigaraki bath",
  "coordinate": { "latitude": 35.0061, "longitude": 135.7554 },
  "price": { "label": "$1,477 for 5 nights", "amount": "$1,477", "original_amount": null, "qualifier": "for 5 nights" },
  "rating": { "score": 5, "reviews": 8, "label": "5.0 (8)" }
}

{ "date": "2026-10-24", "available": true, "bookable": true, "available_for_checkin": true, "available_for_checkout": false, "min_nights": 1, "max_nights": 1125 }

import csv
import os
import sys
import time
from datetime import date, timedelta

import requests

BASE = "https://api.toolzerhub.com/v1/airbnb"
HEADERS = {"x-api-key": os.environ.get("TOOLZERHUB_API_KEY", "")}
FIELDS = ["checked_on", "stay_id", "type", "title", "name", "rating", "reviews", "price",
          "closed_next_30", "closed_next_90", "min_nights_today", "url"]


def get(path, params, tries=3):
    # 429, 5xx and dropped connections are retried; failed calls cost no credits.
    for attempt in range(tries):
        last = attempt == tries - 1
        try:
            r = requests.get(f"{BASE}/{path}", headers=HEADERS, params=params, timeout=120)
        except requests.RequestException:
            if last:
                raise
            time.sleep(10 * (attempt + 1))
            continue
        if r.status_code in (429, 500, 502, 503, 504) and not last:
            time.sleep(10 * (attempt + 1))
            continue
        r.raise_for_status()
        return r.json()["data"]


def stays_for(place, count):
    if os.path.isfile(place):  # a file of stay ids, one per line: the same stays every run
        ids = [line.strip() for line in open(place) if line.strip()]
        return [{"id": i, "url": f"https://www.airbnb.com/rooms/{i}"} for i in ids]
    found = get("stays/search", {"destination": place, "count": int(count)})
    if not found or not found["stays"]:
        sys.exit(f"Airbnb found no stays for {place!r}")
    if not found["location"]["resolved"]:  # unrecognised places can return unrelated stays
        sys.exit(f"Airbnb did not recognise {place!r}; try 'City, Country'")
    print(f"{len(found['stays'])} stays in {found['location']['canonical_location']}")
    return found["stays"]


def closed(days, start, n):
    # Unavailable nights in the n days from start: booked or blocked by the host.
    window = {(start + timedelta(i)).isoformat() for i in range(n)}
    seen = [d for d in days if d["date"] in window]
    return sum(not d["available"] for d in seen), len(seen)


def main(place, count="20", out="airbnb_calendar.csv"):
    stays = stays_for(place, count)
    today, written = date.today(), 0
    new_file = not os.path.exists(out)
    with open(out, "a", newline="", encoding="utf-8-sig" if new_file else "utf-8") as f:
        writer = csv.DictWriter(f, fieldnames=FIELDS)
        if new_file:
            writer.writeheader()
        for s in stays:
            try:  # 4 months from the 1st of this month covers the next 90 days
                cal = get("stay/availability", {"stay_id": s["id"], "months": 4})
            except requests.RequestException as e:
                print(f"{s['id']}: calendar failed ({e})")
                continue
            if not cal:
                print(f"{s['id']}: no calendar")
                continue
            try:  # search mixes in hotel rooms; property_type says which (HOTEL)
                d = get("stay/detail", {"stay_id": s["id"]}) or {}
            except requests.RequestException:
                d = {}
            c30, n30 = closed(cal["days"], today, 30)
            c90, n90 = closed(cal["days"], today, 90)
            first = next((x for x in cal["days"] if x["date"] == today.isoformat()), {})
            rating = s.get("rating") or d.get("rating") or {}
            writer.writerow({
                "checked_on": today.isoformat(), "stay_id": s["id"],
                "type": d.get("property_type"), "title": s.get("title"),
                "name": s.get("name") or d.get("name"), "rating": rating.get("score"),
                "reviews": rating.get("reviews"), "price": (s.get("price") or {}).get("label"),
                "closed_next_30": f"{c30}/{n30}", "closed_next_90": f"{c90}/{n90}",
                "min_nights_today": first.get("min_nights"), "url": s["url"],
            })
            written += 1
    print(f"{written} of {len(stays)} stays appended to {out}")


if __name__ == "__main__":
    if len(sys.argv) < 2:
        sys.exit('usage: python airbnb_calendar.py "Lisbon, Portugal" [count] [file.csv]\n'
                 '   or: python airbnb_calendar.py stay_ids.txt 0 [file.csv]')
    if not HEADERS["x-api-key"]:
        sys.exit("set TOOLZERHUB_API_KEY first")
    main(*sys.argv[1:])