# Airbnb Calendar · Availability & Occupancy

A travel tool your agent can run on one prepaid apifare key. Page: https://apifare.com/tools/corent1robert/airbnb-calendar-availability-scraper

## What you need

An apifare key with credits (sign up: POST https://apifare.com/v1/signup {"email": "..."}; new accounts get 500 free credits). No other account or key.

## Inputs

- `urls` (array, required): Airbnb URLs (e.g. ["https://www.airbnb.com/rooms/25497233"])
- `monthsAhead` (string): Months ahead (e.g. "1")
- `maxPages` (integer): Max search pages (e.g. 1)
- `maxListings` (integer): Max listings (e.g. 5)
- `discoveryMode` (string): Discovery mode (search URLs only) (e.g. "quick")
- `detectChanges` (boolean): Compare occupancy to previous run

The most relevant fields; the search result's input_schema lists all of them.

## Price

5 credits reserved per run, settled to the run's true cost, never more than 20 credits (1 credit = $0.01). Failed runs are refunded. Exact numbers: https://apifare.com/capabilities

## Run it

1. Find it: MCP search_apis, or GET https://apifare.com/v1/search?q=Airbnb%20Calendar%20%C2%B7%20Availability%20%26%20Occupancy with Authorization: Bearer <token>. Take the result named "Airbnb Calendar · Availability & Occupancy"; it carries a proxy_route.
2. Run it: MCP proxy_call with that proxy_route and the input JSON (apifare-mcp over stdio), or POST the proxy_route over HTTP with the input JSON as the body and the same Authorization header.
3. On HTTP 402, relay the body's human_readable field to your human verbatim, wait, then retry the same call. Every other error and its fix: https://apifare.com/errors.md