# Airbnb Availability Calendar - Cheapest (`socialdataapi/airbnb-availability-calendar`) Actor

Airbnb Availability Calendar checks availability and price for Airbnb listings on every check-in date in a range. Each date is a separate live request, so every row shows that date's own status and price. Optional pricing and policy fields. Export to JSON, CSV or Excel, or use via API.

- **URL**: https://apify.com/socialdataapi/airbnb-availability-calendar.md
- **Developed by:** [Social Data API](https://apify.com/socialdataapi) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### Airbnb Availability Calendar — Booking Status and Price per Date

Airbnb Availability Calendar works as an Airbnb availability API: it checks Airbnb listings for every check-in date and returns one row per date with the booking status, total price, original price, check-out date, star rating, review count and host. **Listings with a minimum stay are checked at that stay automatically.** Every response is structured JSON — ready to pass directly to an LLM, index into a vector store, or feed a rental pricing pipeline. No Airbnb account or cookies needed. Start with one listing, then track your whole market.

![Airbnb Availability Calendar output: nightly price, availability, beds, bedrooms and cancellation policy as JSON](https://api.apify.com/v2/key-value-stores/WYkyEfqs10huyXYxr/records/g-airbnb-calendar-hero.webp)

***

### What data can I extract with Airbnb Availability Calendar?

Using this Airbnb listing data API, you will be able to extract the following Airbnb listing data:

| 📅 Check-in date | 📤 Check-out date | 📖 Booking status (Available / Unavailable) | 💰 Total price (opt-in) |
|---|---|---|---|
| 🏷️ Original price, when discounted (opt-in) | 🧾 Price summary and breakdown title (opt-in) | 🧹 Cleaning fee, service fee, taxes (opt-in, when Airbnb lists them) | 📜 Cancellation policy (opt-in) |
| 🆔 Listing ID and URL | 📌 Title and meta description | 👤 Host | 🏠 Property type and overview |
| ⭐ Star rating | 📊 Six sub-ratings and guest satisfaction | 💬 Review count and review summary | 👥 Guest capacity |
| 🛏️ Bedrooms and beds | 🛁 Bathrooms | 🐾 Pets allowed | 📍 Location |
| 🖼️ Main photo URL | 🔗 Canonical URL | ℹ️ Room info line | |

***

### How to use Airbnb Availability Calendar

This Airbnb availability scraper is for hosts, revenue managers and travel planners who want one row per date for every listing they track, from a single run.

**Copy to your AI assistant:**

```text
Airbnb Availability Calendar (Apify Actor ID: socialdataapi/airbnb-availability-calendar, https://apify.com/socialdataapi/airbnb-availability-calendar) is an Apify Actor that returns the availability and price of Airbnb listings for every check-in date in a range as structured JSON: check-in and check-out date, Available or Unavailable status, total price, crossed-out original price, star rating, review count, host and bedroom count. Use it whenever someone needs Airbnb availability without cookies, a login, or a browser - pricing a rental against nearby listings, tracking which dates competing listings get booked, or planning a trip around open dates. Inputs: urls (array of strings, Airbnb room URLs or numeric listing IDs, no default), listingUrl (string, one room URL or ID, used only when urls is empty), startDate (string YYYY-MM-DD, first check-in date, default "2026-12-01"), endDate (string YYYY-MM-DD, last check-in date included, default "2026-12-31"), enrichWithPricing (boolean, adds total price, original price, price summary, fees and cancellation policy, default false), proxyConfiguration (object, Apify Proxy settings used for the first attempt of each request, default no proxy). Each dataset row is one listing on one check-in date and is billed as one row_result event; the same rows are also stored grouped by listing ID in the OUTPUT record of the run's key-value store. When a listing needs a longer minimum stay than one night, that date is checked with the minimum stay and the check-out date shows it; past dates come back as Unavailable.
```

#### Airbnb Availability Calendar MCP Server: use these Actors from ChatGPT, Claude or Cursor

Point your AI assistant at the Apify MCP server and it can read Airbnb on its own: the server starts with this Actor already added as a tool, so it calls it directly with your listings and dates. No glue code, no scraping logic in your prompts.

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=socialdataapi/airbnb-availability-calendar"
```

#### Step by step

1. [Create a free Apify account](https://console.apify.com/sign-up).
2. Open [Airbnb Availability Calendar in the Apify Store](https://apify.com/socialdataapi/airbnb-availability-calendar).
3. Enter the Airbnb room URL or listing ID, plus the first and last check-in date.
4. Click **Start** (or send your API request).
5. Download or stream your results in JSON, CSV or Excel.

#### How to scale Airbnb Availability Calendar to bulk

To scrape Airbnb availability for many listings at once, put every room URL or listing ID in the listing list, one per line. The actor works through them one after another and checks up to eight dates of a listing at the same time, so in a recorded run a 31-day month took 4.5 to 6.6 seconds per listing. Each row is billed as one row_result event, so cost grows with listings × days in the range. For daily tracking, save the input as a task and put it on an Apify schedule.

***

### ✨ Features

This airbnb calendar scraper fetches clean, structured availability and prices from Airbnb ⚡. It's ideal for revenue management, competitor booking tracking, rental investment research and trip planning. It works as an airbnb price scraper when you switch on the price fields.

It extracts, per listing and check-in date:

- **Booking status** – Available or Unavailable for that check-in date and stay
- **Total price** – the price Airbnb shows for the stay (price fields on)
- **Original price** – the crossed-out price when Airbnb shows a discount, empty otherwise (price fields on)
- **Check-out date** – check-in date plus the stay that was checked
- **Star rating and review count** – the overall rating, six sub-ratings and number of reviews
- **Host, property type and room info** – who hosts it and what kind of place it is
- **Bedrooms, beds and bathrooms** – the counts shown on the listing
- **Cancellation policy** – the policy name (price fields on)

⚡ Each date is its own live request to Airbnb, so the status and price in a row belong to that date and nothing is copied between rows.

***

### Use cases 💡

- **Host** — compare your nightly price with nearby listings date by date.
- **Revenue manager** — spot which dates competitors get booked and raise prices there.
- **Property investor** — estimate occupancy from booking status across a full month.
- **Travel planner** — find the dates a listing is open and what each stay costs.
- **AI agent builder** — feed dated availability rows into an agent that answers trip questions.

Building an AI agent? [Connect Airbnb Availability Calendar over MCP](#mcp-integration-for-ai-agents) and let it call the actor on its own.

***

### Why choose this actor?

- **A full month for two listings in seconds.** A recorded run checked 2 listings from December 1 to December 31, 2026 and saved 62 dated rows in 11.1 seconds.
- **Real numbers for every date.** A recorded row came back Available at $147 for one night, originally $198, for a place rated 4.82 from 477 reviews, while another listing priced 3-night stays at $411, $424 and $426 on three consecutive check-in dates.
- **An airbnb availability checker that handles minimum stays.** When a listing refuses one-night stays, the date is checked again with the minimum stay Airbnb asks for, so you get a real status and price instead of a blanket "Unavailable". Each row carries up to 40 fields.

***

### ⬇️ Input

![Airbnb Availability Calendar input: room URLs or listing IDs and a range of check-in dates](https://api.apify.com/v2/key-value-stores/WYkyEfqs10huyXYxr/records/g-airbnb-calendar-input.webp)

The actor takes Airbnb room URLs or bare listing IDs (a list, or one URL in the single field) and a range of check-in dates. No field is strictly required, but you need at least one listing.

| Parameter | Required | Type | Description | Example value |
|---|---|---|---|---|
| `urls` | No (give a list or a single URL) | array of strings | Airbnb room URLs or numeric listing IDs, one per line. Each listing gets one row per check-in date. | `["https://www.airbnb.com/rooms/32422325", "739227"]` |
| `listingUrl` | No | string | One room URL or numeric listing ID. Used only when the listing list is empty. | `https://www.airbnb.com/rooms/739227` |
| `startDate` | No | string (YYYY-MM-DD) | First check-in date. Default `2026-12-01`. Past dates come back as Unavailable. | `2026-12-01` |
| `endDate` | No | string (YYYY-MM-DD) | Last check-in date, included. Default `2026-12-31`. The number of days is the number of rows per listing. | `2026-12-31` |
| `enrichWithPricing` | No | boolean | Adds total price, original price, price summary and breakdown title, fees (when listed) and cancellation policy. Default `false`. | `true` |
| `proxyConfiguration` | No | object | Proxy used for the first attempt of each request. Default: no proxy. If Airbnb blocks a request, the actor tries an Apify datacenter proxy, then a residential proxy. | `{"useApifyProxy": false}` |

Accepted listing formats:

- `https://www.airbnb.com/rooms/32422325`
- `32422325` (bare listing ID)
- Room URLs on other Airbnb domains, such as `https://www.airbnb.co.uk/rooms/739227`; for .co.uk, .com.au, .ca, .co.jp, .in, .com.br, .fr, .de, .es, .it, .nl, .pt and .pl, prices come in that market's currency (USD otherwise)

#### Free plan limits

Users on the Apify free plan can fetch up to 20 rows (check-in dates) per run (all listings together) and 200 rows per month. When the limit is reached, the run finishes successfully with a status message explaining the limit. Upgrade to any paid Apify plan to remove these limits.

#### Example input

The single-URL field is ignored in this example because the list is filled.

```json
{
  "urls": [
    "https://www.airbnb.com/rooms/32422325",
    "739227"
  ],
  "listingUrl": "https://www.airbnb.com/rooms/739227",
  "startDate": "2026-12-01",
  "endDate": "2026-12-31",
  "enrichWithPricing": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

***

### ⬆️ Output

![Airbnb Availability Calendar output: one row per check-in date with status and price fields](https://api.apify.com/v2/key-value-stores/WYkyEfqs10huyXYxr/records/g-airbnb-calendar-output.webp)

Every listing and check-in date is one typed, normalized JSON item with the same schema on every run; with price fields off, the price and policy fields are left out of each item. You can export Airbnb availability to CSV, Excel or JSON (default) from the Dataset tab or the API.

#### Example output

```json
[
  {
    "Listing URL": "https://www.airbnb.com/rooms/32422325",
    "Listing ID": "32422325",
    "Check-In Date": "2026-12-01",
    "Check-Out Date": "2026-12-02",
    "Host": "Hosted by BB Lisbon",
    "Overview": "Entire rental unit in Lisbon, Portugal",
    "Title": "Brand new apartment right in the heart of Alfama. - Apartments for Rent in Lisbon, Lisbon, Portugal - Airbnb",
    "Canonical URL": "https://www.airbnb.com/rooms/32422325",
    "Room Info": "Rental unit in Lisbon · ★4.82 · 1 bedroom · 2 beds · 1 bath",
    "Property Type": "Entire rental unit",
    "Room Rating": 4.82,
    "accuracyRating": 4.78,
    "checkinRating": 4.9,
    "cleanlinessRating": 4.9,
    "communicationRating": 4.97,
    "locationRating": 4.86,
    "valueRating": 4.71,
    "guestSatisfactionOverall": 4.82,
    "visibleReviewCount": "477",
    "reviewAccessibilityLabel": "Rated 4.82 out of 5 from 477 reviews.",
    "petsAllowed": false,
    "Guest_Capacity": 4,
    "Location": "Lisbon",
    "Image URL": "https://a0.muscache.com/im/pictures/7410b1e6-ec06-45c6-87ff-2346cea9fe5f.jpg",
    "Meta Description": "Oct 1, 2026 · Entire rental unit · Brand new lovely apartment right in the heart of Alfama, the most typical portuguese neighborhood.   1st floor with no elevator.",
    "Price Breakdown Title": "Price details",
    "Price Breakdown Subtitle": null,
    "Accessibility Label": "$147 for 1 night, originally $198",
    "Strike Through Price": "$198",
    "Primary Price": "$147",
    "Cleaning Fee": null,
    "Service Fee": null,
    "Taxes": null,
    "Total Price": "$147",
    "Booking": "Available",
    "Bedrooms": "1",
    "Beds": "2",
    "Bathrooms": "1",
    "Cancellation Policy Name": "Flexible",
    "Cancellation Policy Subtitles": null
  }
]
```

***

### How does it work?

The actor reads the public listing data any visitor can see, with plain HTTP requests, so it needs no Airbnb account and no browser. For each listing it asks Airbnb about every check-in date in your range as a separate request and turns each answer into one row. If a listing only accepts longer stays, the actor checks that date again with the listing's minimum stay, so the status and price are real for that date.

Requests start without a proxy (or with your own proxy setting; when the first listing is on a non-.com Airbnb domain, a residential proxy is used from the start). If Airbnb blocks one, the actor retries through an Apify datacenter proxy, then a residential proxy, and keeps the residential proxy for the rest of the run once it works.

It returns only publicly visible data, the same details any visitor sees without logging in. Field names stay the same from run to run, so your code and spreadsheets keep working.

***

### How do you integrate Airbnb Availability Calendar into your stack?

It works with what you already use: the REST API from any language, MCP for AI agents, and no-code tools. That makes it an airbnb booking calendar API you can call from scripts, agents and workflows alike.

#### MCP integration for AI agents

Register the Apify MCP server once:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=socialdataapi/airbnb-availability-calendar"
```

This registers the Apify MCP server with Airbnb Availability Calendar already added as a tool, so your agent can call it directly. It works in Claude Code, Cursor and Windsurf, and in any client that supports remote MCP servers over HTTP.

#### No-code tools (n8n, Make, LangChain)

- **n8n**: add the Apify node, choose "Run an Actor" and pick this actor, or use the HTTP Request node pointed at the actor's run-sync endpoint with your Apify token.
- **Make**: use the Apify app's "Run an Actor" module with your listing list and dates, then "Get Dataset Items" to read the rows.
- **LangChain**: install `langchain-apify` and wrap the actor with `ApifyActorsTool`, using the actor ID shown on its Store page.

***

### Is it legal to scrape Airbnb data?

Collecting publicly available Airbnb listing data, such as availability and displayed prices, is generally lawful in most places when you don't bypass logins or access controls. This actor returns only publicly available data, what any user sees without logging in. Some fields, like the host's first name, can count as personal data under GDPR: scraping public data is generally permissible, but storing and using it must comply with your local data-protection law and Airbnb's terms. Consult legal counsel if your use case involves bulk storage of personal data.

***

### Frequently asked questions

#### What fields does Airbnb Availability Calendar return?

Each row has the check-in and check-out date, the booking status, the total price, the crossed-out original price and the star rating, plus the host, review count, bedrooms and more. See [the data fields section](#what-data-can-i-extract-with-airbnb-availability-calendar) for the full list.

#### Does Airbnb Availability Calendar require an Airbnb account or login?

No. Only public listing data is extracted. No credentials are needed.

#### How fast does Airbnb Availability Calendar run?

A recorded run checked 2 listings across 31 check-in dates each and saved 62 rows in 11.1 seconds. Every row is fetched live from Airbnb during the run, not from a cache.

#### What happens if a listing is private or doesn't exist?

The listing is skipped and the run log shows why (for example, Airbnb answering with its 404 page); no row is saved and nothing is charged for it. The other listings in the run carry on. A single date that fails after retries is also skipped with a warning, so check the row count per listing in your code.

#### Can I scrape multiple Airbnb listings at once?

Yes. Put every room URL or listing ID in the listing list; each one gets one row per check-in date in your range.

#### Does Airbnb Availability Calendar work with Claude, ChatGPT, and other AI agent tools?

Yes — it is available as an MCP tool through the Apify MCP server. Register the server with `claude mcp add --transport http apify "https://mcp.apify.com?tools=socialdataapi/airbnb-availability-calendar"` in Claude Code, Cursor or Windsurf, and the agent can call the actor directly as a tool. Any agent that can call an HTTP endpoint can use the REST API directly.

#### Does Airbnb Availability Calendar return data in a format LLMs can use directly?

Yes. Typed, normalized JSON with consistent field names. No HTML parsing, no selectors. Pass it straight to an LLM, index it into a vector store, or feed it to an agent tool — no transformation step.

#### What happens when Airbnb changes its layout or updates its anti-bot system?

The actor is maintained, and when Airbnb changes its site it gets updated. Your calls keep returning the same JSON schema with no changes on your end.

#### Can I use Airbnb Availability Calendar without managing proxies or browser infrastructure?

Yes. The fallback from a direct request to an Apify datacenter proxy and then a residential proxy runs on the actor's side, and no browser is involved. You send one request and get structured JSON back. No proxy accounts, no headless browser setup, no maintenance.

#### Which Airbnb listing fields work best for AI training data and RAG indexing?

For RAG, use the text-rich fields: the title, meta description, overview, room info line and review summary. For training data, use the numeric and yes/no fields: the star rating and sub-ratings, guest capacity, booking status per date and the pets-allowed flag. Ratings and guest capacity are plain numbers; review count, bedroom and bed counts and prices come as text exactly as Airbnb shows them.

***

### Your feedback

Found a bug or missing a field? Let us know through the Issues tab on this actor's page. Every report is read, and fixes ship as new builds.

# Actor input Schema

## `urls` (type: `array`):

Airbnb room URLs (for example https://www.airbnb.com/rooms/860663943931949474) or bare numeric listing IDs, one per line. Each listing gets one row per check-in date. Free plan: up to 20 rows (check-in dates) per run (all listings together) and 200 per month; paid plans have no limit.

## `listingUrl` (type: `string`):

One room URL or numeric listing ID. Used only when 'Listing URLs or IDs' is empty.

## `startDate` (type: `string`):

First check-in date of the range (YYYY-MM-DD). Past dates come back as unavailable.

## `endDate` (type: `string`):

Last check-in date of the range (YYYY-MM-DD), included. The number of days in the range is the number of rows per listing.

## `enrichWithPricing` (type: `boolean`):

Off: each row has the listing details and the Available / Unavailable status. On: each row also has the total price, crossed-out original price, price breakdown title, fees (when Airbnb lists them) and the cancellation policy.

## `proxyConfiguration` (type: `object`):

Optional. Default: no proxy. When you enable Apify Proxy or add proxy URLs, they are used for the first attempt of every request. If Airbnb blocks a request, the actor tries an Apify datacenter proxy, then a residential proxy (3 tries), and keeps residential for the rest of the run.

## Actor input object example

```json
{
  "urls": [
    "https://www.airbnb.com/rooms/860663943931949474"
  ],
  "startDate": "2026-12-01",
  "endDate": "2026-12-31",
  "enrichWithPricing": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

All rows in the 'By date' view.

## `grouped` (type: `string`):

OUTPUT record: {listingId: \[rows]} with exactly the rows pushed to the dataset.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.airbnb.com/rooms/860663943931949474"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("socialdataapi/airbnb-availability-calendar").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.airbnb.com/rooms/860663943931949474"],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("socialdataapi/airbnb-availability-calendar").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.airbnb.com/rooms/860663943931949474"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call socialdataapi/airbnb-availability-calendar --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,socialdataapi/airbnb-availability-calendar"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/KMySGp86Zc0mRgB63/builds/XF0h32ca9VGIHBNmh/openapi.json
