Airbnb occupancy rate per listing and month from the availability calendar, by place or listing id. One row per listing and month: days available, days blocked or booked, occupancy %, minimum stay, nightly rate. Short term rental data, vacation rental comps, competitors. Free: filtered months.
Shared Airbnb client of airbnb-prices-calendar 1.14. Sampled rates (rate_total, rate_nightly) are always on one basis, the stay total before taxes. Exits in the EU and UK see totals with taxes (Lisbon's tourist tax, about 8%), and the proxy pool mixes countries, so about 3% of rates came with taxes; such a total is now turned back into the total before taxes from its own price lines. A rate Airbnb gives in another currency than asked (it answers a currency it does not offer, such as GEL, in USD) is no longer delivered as yours: that month's rate is left empty (rate_status "unpriced"). An empty first search page that Airbnb did not count as empty is asked again from other IPs. Output fields, inputs, defaults and prices are unchanged.
1.6 — 2026-11-17
Shared Airbnb client of airbnb-prices-calendar 1.11. A whole-country search such as "United States" or "India" is no longer mistaken for a place Airbnb did not recognise because its listings lie far apart: Airbnb resolved it (it gives the search a canonical URL), so its listings and their occupancy are delivered instead of an unknown_area status row. Output fields, inputs, defaults and prices are unchanged.
1.5 — 2026-11-17
Shared Airbnb client of airbnb-prices-calendar 1.10. Listing rows of hotels no longer carry the hotel's name as property_type (now "Hotel"), and titles in other languages ("Loft ⋅ Lisbonne", "Loft em Lisboa") are split into type and area. Pasted search URLs keep every filter of the site's panel (Instant Book, free cancellation, Guest favorite, property types and more). When Airbnb retires or renames a query, the run fails with a message naming it and the similar queries the site registers now, and a rotated hash of the reviews query is found in the site's lazily loaded code; the query hashes are the ones airbnb.com registers today. Output fields, inputs, defaults and prices are unchanged.
1.4 — 2026-11-16
Near the run timeout the run starts no new search, listing or rate sample and the shared Airbnb client sends nothing more, so the run ends green with SUMMARY written instead of being killed; a month whose rate sample the deadline cut ships with rate_status skipped, and listings it never reached are counted in SUMMARY and never charged. Otherwise behaviour, output fields, defaults and billing are unchanged. No prices changed.
1.3 — 2026-11-16
Never billed past maxTotalChargeUsd: each charge asks the platform only for the occupancy rows that still fit under the spending limit, under one lock shared by every concurrent listing, and exactly those are delivered; the run then ends — spending limit reached. Apify SDK 4.2 answers a request for more events than still fit by billing one event past the limit (a $0.30 limit was billed $0.302 on google-hotels-prices on 2026-11-16), and a limit below the price of one occupancy row was billed one occupancy row. Runs without a spending limit, or whose limit is not reached, are unchanged: no prices, input fields, defaults or output fields changed.
1.2 — 2026-11-16
Shared Airbnb client fixes, the same ones airbnb-prices-calendar 1.5 ships: a query-hash rotation mid-run is refreshed once for every request in flight instead of spending their retries, and throttled answers (429/403/5xx/network) back off before the next IP. Behaviour, output fields, defaults and billing are unchanged. No prices changed.
2026-11-14 — 1.1: Restore availability calendars
Airbnb retired the PdpAvailabilityCalendar query (HTTP 400 deprecated operation, which also defeated the hash refresh). Read calendars through the PdpAvailabilityCalendarV2ExcludedQuery listing-node query Airbnb's own pages now use. Output fields, filters, billing and prices are unchanged.
2026-11-13 — Restore previous listing keywords
Restore title, description and SEO text to the November 5 baseline at the owner’s request. Preserve current runtime fixes, input/output contracts, billing, prices and defaults.
2026-11-12 — Restore Airbnb search after query rotation
Update the public search and listing query identifiers. Recognize Airbnb’s HTTP 400 deprecated-operation response and refresh once, rebuilding both the URL and request extensions before retrying. Read listing details from Airbnb’s new listing-node response as well as legacy sections. Preserve output fields and prices.
2026-11-06 — MCP discovery metadata
Clarify supported search intents and output nouns in the Store listing. Runtime, input contract, output and prices are unchanged.
Changelog
2026-10-16 — Keyword Planner and locale documentation
Validated search terminology against Google Ads Keyword Planner and Store shelves. Added localized usage guidance and bounded examples; retained existing English phrases. Clarified locale limitations where measured. Corrected current-versus-scheduled price wording and arithmetic. No runtime, output fields, defaults, or pricing changed.
price change, set 2026-10-12, effective 2026-10-27
occupancy $0.002 → $0.003 per row (the only per-row-priced occupancy actor; AirDNA-class data). the actor has paying users, so Apify applies the increase on 2026-10-27 and notified them; until then the old price bills and the listing text below describes the price from that date; nothing else changes — same rows, same free rows, same filters, no start fee, proxy and compute included. Every price mention in the input form, the event text and this README was updated with it.
1.0 — listing and input form reworded, 2026-10-11
No behaviour, output or price changed; the same inputs return the same rows.
Title: "Occupancy Rate" kept (it ranks first for that phrase); the tail now carries the nouns investors and agents type — "Nightly Rate, ADR & Market Data" — instead of "Calendar Availability", which the description keeps.
Description says what one row is (days available, days blocked or booked, occupancy %, minimum stay, nightly rate), the three ways in, and that filtered months are free.
The input form is reordered: what to measure, then months, maxListingsPerQuery, includeRates, adults, minOccupancyPct, includeListingRow, then currency and language, then proxy and pacing. Nothing was renamed or removed.
Every input now says what to pass, with an example, its default, what it changes and what it costs.months and maxListingsPerQuery state the bill as listings × months; includeRates says it is on by default, what it samples and that it adds requests but no charge; minOccupancyPct says the filter runs before billing and before the rate sample; adults says what a listing too small for the party answers.
The pricing text gives worked sizes (12 months of one listing, a 100-listing market for 6 months), lists what is never charged, that there is no start fee, and that a run stops at the maximum cost you set.
README: a section mapping common requests to the exact input and the status contract. seoDescription carries nightly rate, ADR, comps, the AirDNA alternative and the Spanish, German and Portuguese words for occupancy.
2026-08-30
Reliability: a run that cannot act on its input — a URL from the wrong site, a name nothing resolves to, an empty target list, a number outside the documented range — now ends cleanly with the reason on the run card instead of as a failed run. Nothing is charged in either case; a blocked or throttled source still fails loudly.
Store listing: moved into the categories buyers actually browse (the old Business category has no Store page).
1.0 — 2026-08-29
First release.
One occupancy row per listing and calendar month from the public availability calendar: days counted (today onward), days available, days blocked or booked, occupancy_pct, check-in days, the typical minimum stay and the next free day.
A sampled nightly rate per month (includeRates, on by default): the first bookable stay of the month — check-in on the first available day, the listing's minimum nights, capped at 7 — priced for adults guests, so each row carries rate_nightly, rate_total and the sampled dates. An ADR proxy, one extra request per listing and month.
Address listings by place search (locationQueries), pasted Airbnb search or listing URLs (startUrls) or ids (listingIds); the unknown-place guard from the Airbnb Scraper is kept, so a misspelt place costs nothing.
minOccupancyPct filter: only months at or above the line are delivered, and the filter runs before billing.
Optional free listing rows (includeListingRow) with name, type, location, rating and reviews.
Billing: pay per delivered occupancy row. Filtered months, listing rows, status rows, unknown places and failed calendars are free, and nothing a spending limit refused is ever delivered.
Honest by design: the calendar does not say whether a night is booked or host-blocked, so every occupancy figure is a proxy and the README says so; a failed rate sample is a null rate with rate_status, never a fabricated number.