Airbnb Availability Calendar Scraper

Airbnb Availability Calendar Scraper returns a listing's calendar day by day for up to 12 months: whether each night is available, whether you can check in or out that day, and the minimum and maximum stay. It can also price check-in dates with Airbnb's own booking quote, the same nightly price, taxes and total a guest sees, for an even sample of dates or for every valid date. Use it to estimate occupancy, study seasonality and dynamic pricing, or monitor competing short-term rentals.

Powered by the ScraperCompany API: requests, proxies, retries and anti-bot handling run on ScraperCompany's servers, so you don't need your own proxies or API key. Start a run, get structured JSON.

What can this scraper do?

• Day-by-day availability for 1-12 months per listing.
• Check-in / check-out rules, minimum and maximum nights, closed-to-arrival and closed-to-departure.
• Quoted prices for sampled or all valid check-in dates: nightly price, accommodation, taxes and total, with breakdown.
• Summary per listing: available days, bookable days, min/median/max nightly price.
• Any party size (adults, children, infants, pets) and stay length for quotes.
• You only pay for nights that were actually priced.

What data can you extract?

Field	Description
days[].date / available / bookable	Availability per day
days[].available_for_checkin / available_for_checkout	Check-in and check-out rules
days[].min_nights / max_nights	Stay limits from that day
days[].price	Quoted price: price_per_night, accommodation, taxes, total, breakdown
summary	Available, bookable and priced day counts; min/median/max nightly price
listing	Constant minimum nights, max guests, pets/children allowed (and title, rating, coordinates with Include listing details)
currency / guests	Currency and party the quotes are for

Every dataset item also carries input (the exact request that was sent), request_id (quote it to support), billed and scraped_at.

How to use Airbnb Availability Calendar Scraper

1. Open Airbnb Availability Calendar Scraper in Apify Console and go to the Input tab.
2. Enter Airbnb listing ids (the number after /rooms/ in a listing URL), how many months to return, and how many nights to price.
3. Adjust the options if needed. Dates accept an exact date (2026-12-01) or a relative one (30 days from today), so saved tasks and schedules never go stale.
4. Click Start and wait for the run to finish.
5. Download the results from the Output tab as JSON, CSV, Excel or HTML, or fetch them with the Apify API.

Input example

This is the default input; running the Actor without changes uses it.

{
  "listingIds": [
    "34397368"
  ],
  "months": 2,
  "price_nights": "sample",
  "max_price_quotes": 8,
  "includeErrors": true,
  "maxConcurrency": 3,
  "maxRetries": 2
}

Output example

One dataset item per request (trimmed here; real items contain every field the API returns):

{
  "endpoint": "/v1/airbnb/calendar",
  "input": {
    "listing_id": "34397368",
    "months": 2,
    "price_nights": "sample",
    "max_price_quotes": 8
  },
  "airbnb_domain": "airbnb.ca",
  "currency": "CAD",
  "days": [
    {
      "available": false,
      "available_for_checkin": false,
      "available_for_checkout": false,
      "bookable": false,
      "closed_to_arrival": false,
      "closed_to_departure": false,
      "date": "2026-10-10",
      "max_nights": 27,
      "min_nights": 2,
      "price_status": "unavailable"
    },
    {
      "available": true,
      "available_for_checkin": true,
      "available_for_checkout": true,
      "bookable": true,
      "closed_to_arrival": false,
      "closed_to_departure": false,
      "date": "2026-10-14",
      "max_nights": 27,
      "min_nights": 2,
      "price": {
        "accommodation": 356,
        "breakdown": [
          {
            "description": "2 nights x $178.00 CAD",
            "extracted_price": 356,
            "kind": "nights",
            "price": "$356.00 CAD"
          },
          {
            "description": "Taxes",
            "extracted_price": 67.64,
            "kind": "tax",
            "price": "$67.64 CAD"
          }
        ],
        "check_in": "2026-10-14",
        "check_out": "2026-10-16",
        "currency": "CAD",
        "display_style": "REGULATED_TOTAL",
        "display_total": "$424 CAD",
        "nights": 2,
        "price_basis": "nightly_all_in_before_taxes",
        "price_per_night": 178,
        "price_per_night_text": "$178.00 CAD",
        "provenance": {
          "collection_id": "ratecol_c328ca4cf9a747448dc64c2e80f86e25",
          "collector": "scrapingme.ota.airbnb_calendar",
          "derivation": "airbnb_stay_average_nightly",
          "egress_mode": "direct",
          "observation_id": "rateobs_9e60ad832506e113550acd2fe556ad55",
          "observed_at": "2026-09-30T22:48:15.032Z",
          "price_basis": "nightly_all_in_before_taxes",
          "requested_currency": "CAD",
          "requested_market": "airbnb.ca",
          "returned_currency": "CAD",
          "schema_version": 1,
          "source": "airbnb",
          "source_kind": "vacation_rental_stay_quote",
          "source_property_id": "34397368"
        },
        "taxes": 67.64,
        "total": 423.64,
        "total_text": "$423.64 CAD"
      },
      "price_status": "priced"
    }
  ],
  "guests": {
    "adults": 2,
    "children": 0,
    "infants": 0,
    "pets": 0
  },
  "link": "https://www.airbnb.ca/rooms/34397368",
  "listing": {
    "children_allowed": true,
    "constant_min_nights": 2,
    "max_guests": 2,
    "pets_allowed": false
  },
  "listing_id": "34397368",
  "max_price_quotes": 8,
  "metadata": {
    "calendar_operation": "PdpAvailabilityCalendar",
    "collection_id": "ratecol_c328ca4cf9a747448dc64c2e80f86e25",
    "egress": [
      "direct"
    ],
    "observed_at": "2026-09-30T22:48:15.032Z",
    "parsing_time_taken": 0.001,
    "price_quotes": 8,
    "request_time_taken": 4.69,
    "total_time_taken": 1.52,
    "upstream_requests": 9,
    "wire_bytes": 8913
  },
  "months": 2,
  "price_nights": "sample",
  "requested_currency": "CAD",
  "start_month": 10,
  "start_year": 2026,
  "summary": {
    "available": 35,
    "available_for_checkin": 31,
    "bookable": 34,
    "days": 61,
    "max_price_per_night": 178,
    "median_price_per_night": 178,
    "min_price_per_night": 169.5,
    "price_status": {
      "check_in_not_allowed": 4,
      "not_sampled": 23,
      "priced": 8,
      "unavailable": 26
    },
    "priced": 8
  },
  "request_id": "req_3f9c0d6e2b8a4c1f9e7d5b3a1c0e8f6d",
  "billed": true,
  "scraped_at": "2026-10-01T14:03:27.512Z"
}

A request that fails is saved with an error message instead (turn off Include failed requests to skip those). Failed requests are never charged.

How much does it cost?

This Actor uses pay-per-event pricing: you pay for successful API requests, not for compute time.

Event	Charged when	Price	Per 1,000
calendar-request	One listing's day-by-day availability, minimum/maximum nights and check-in rules for 1-12 months.	$0.012	$12.00
priced-night	One check-in date priced with Airbnb's own quote (nightly price, taxes and total). Charged only for nights actually priced.	$0.0015	$1.50

For example, 1,000 listing calendars with 8 priced nights each cost $12.00 + $12.00 = $24.00; availability-only calendars (Price nights: None) cost $12.00 per 1,000.

• Failed requests (errors, invalid input, blocked upstream after retries) are free.
• Requests where the source returns nothing at all (no results, nothing priced) are saved but not charged.
• Set Maximum cost per run when you start a run and the Actor stops cleanly before going over it.

FAQ

Do I need proxies or a ScraperCompany API key?

No. Proxy rotation, retries and anti-bot handling run on the ScraperCompany side, and the Actor is already connected to the API. You only pay the per-event prices above.

How are priced nights charged?

Each night the API actually priced is one priced-night event ($0.0015). Nights that could not be priced (unavailable, check-in not allowed) are free. Use Max priced nights to cap the cost per listing.

Why does the nightly price change with stay length?

Airbnb folds cleaning and service fees into the nightly rate, so the same night costs less per night on a longer stay. Set Stay length for quotes to compare like with like.

Is it legal to scrape this data?

The Actor collects publicly available information that anyone can see without logging in. You are responsible for how you use the results: respect the source site's terms, copyright and privacy law (such as GDPR) and do not collect personal data without a lawful basis. If in doubt, ask a lawyer.

What happens when a request is blocked or rate-limited?

Rate limits (HTTP 429) and temporary errors (5xx) are retried automatically with exponential backoff, respecting Retry-After. If a request still fails it is saved with the error message and not charged, and the rest of the batch keeps going. A run only fails when every request failed.

Why did a request return an error?

Read the error field: validation problems (for example a malformed date or an unknown id) are reported exactly as the API sees them. Fix the input and run again; failed requests cost nothing.

How many requests can I run at once?

Any number per run. The Actor sends up to 3 requests in parallel by default (change it under Run options); larger batches simply take longer.

Use it from your code

Call the Actor from any language through the Apify API. With the JavaScript client (npm install apify-client):

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('scrapercompany/airbnb-availability-calendar-scraper').call({
    "listingIds": [
        "34397368"
    ]
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

With Python (pip install apify-client):

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("scrapercompany/airbnb-availability-calendar-scraper").call(run_input={
    "listingIds": ["34397368"],
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

You can also schedule runs, chain them with webhooks, or connect them to Make, Zapier, n8n, Google Sheets and other integrations from the Integrations tab.

Related scrapers

• Airbnb Search Scraper
• Vrbo Rates Scraper

Support

Questions, a field you need, or a site that stopped working? Open an issue on the Issues tab or contact us at scrapercompany.com. Include the request_id from the dataset item so we can trace the request.