Airbnb API endpoint
Returns the public availability calendar for one Airbnb room, grouped by month. Each day carries its date, whether it is available and bookable, whether it can be a check-in or check-out day, and the minimum and maximum nights. Months are returned only when Airbnb exposes them for the listing.
/airbnb/room/{id}/calendar| Field | Filled in, of 12 checked | Values in the sample |
|---|---|---|
| month | 12 | 1 to 12, median 6 |
| year | 12 | 2,026 to 2,027, median 2,027 |
| days | 12 | median 31 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Room id | 1384733959726184048 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/airbnb/room/1384733959726184048/calendar" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "12345678",
"months": [
{
"month": "june",
"year": 2026
}
]
}
}Request schema
No body schema
Response schema
#/definitions/airbnb.CalendarResponse
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| id | string | No | 12345678 | Airbnb room id the calendar belongs to. | ||
| months | array | No | Availability by month. | |||
| months[].days | array | No | One entry per day of the month. | |||
| months[].days[].available | boolean | No | True when the night is free. | |||
| months[].days[].available_for_checkin | boolean | No | True when a stay can start on this day. | |||
| months[].days[].available_for_checkout | boolean | No | True when a stay can end on this day. | |||
| months[].days[].bookable | boolean | No | True when the day can be booked. | |||
| months[].days[].date | string | No | 2026-07-01 | Calendar date (YYYY-MM-DD). | ||
| months[].days[].max_nights | integer | No | Maximum stay, in nights, for a booking that starts on this day. | |||
| months[].days[].min_nights | integer | No | Minimum stay, in nights, for a booking that starts on this day. | |||
| months[].month | string | No | Month, as a number from 1 to 12 or a month name. | |||
| months[].year | integer | No | Four-digit year. |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/airbnb/room/1384733959726184048/calendar" \
-H "x-api-key: $CRAWLORA_API_KEY"