# Airbnb Listing Search

> Airbnb Listing Search is a paid API for AI agents from AIsa MPP Data APIs at api.aisa.one, paid per call via MPP, $0.001/call, status unknown (last checked 2026-10-14).

Searches Airbnb listings by location, dates, guest count, amenities, and price filters, returning matching properties with pricing details.

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/airbnb/search?utm_source=zero.xyz
- Price: $0.001/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: AIsa MPP Data APIs
- Website: https://aisa.one
- Tags: web-search, financial-data, prediction-markets, weather, travel, data, search
- Canonical page: https://www.zero.xyz/c/aisa-mpp-data-apis-airbnb-listing-search-6518e170
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Z2Ykk4nUM-VjUwC3jw0Cz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aisa-mpp-data-apis-airbnb-listing-search-6518e170
```

Example prompt: Search Airbnb for listings in Barcelona for 2 adults and 1 child checking in on June 15 and checking out June 22, with at least 2 bedrooms, a pool, and wifi, priced under $250 per night in USD.

## When to prefer this

Use this endpoint when you need to programmatically search Airbnb short-term rental listings with flexible filtering by location, dates, guests, amenities, and price. It is the right choice when a user wants to discover vacation rentals or short-term accommodation on Airbnb specifically, as opposed to hotels (use a hotel search API) or long-term apartment rentals (use a real estate API). Prefer this over generic web search when structured, filterable Airbnb listing data with pricing is needed.

## Known failure modes

- No results found for the given location or filters — error message returned
- Invalid or past check-in/check-out dates cause a validation error
- Conflicting parameters (e.g. both time_period and check_in_date) cause a request error
- Unsupported currency code returns a validation error
- Missing required 'engine' parameter causes a 400-level error
- Bounding box format incorrect or both q and bounding_box omitted causes error

## How this service works

<!-- aisa-pricing:start -->
Published reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->

## Output

Returns an array of Airbnb property listings matching the filters, each with a unique listing ID, a direct URL to the property page, pricing details (per-night price, original price, discount, total price, and all-in total with taxes broken down by line item), and a pagination token for retrieving additional results. If no listings match, an error message is returned instead.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "engine"
 ],
 "properties": {
  "q": {
   "type": "string",
   "description": "Search query for location (e.g., \"Barcelona\", \"Paris\"). Either q or bounding_box is required."
  },
  "beds": {
   "type": "integer",
   "maximum": 8,
   "minimum": 0,
   "description": "Minimum number of beds"
  },
  "pets": {
   "type": "integer",
   "maximum": 5,
   "minimum": 0,
   "description": "Number of pets"
  },
  "adults": {
   "type": "integer",
   "maximum": 16,
   "minimum": 0,
   "description": "Number of adult guests"
  },
  "engine": {
   "enum": [
    "airbnb"
   ],
   "type": "string",
   "description": "Search engine identifier"
  },
  "infants": {
   "type": "integer",
   "maximum": 5,
   "minimum": 0,
   "description": "Number of infant guests"
  },
  "bedrooms": {
   "type": "integer",
   "maximum": 8,
   "minimum": 0,
   "description": "Minimum number of bedrooms"
  },
  "children": {
   "type": "integer",
   "maximum": 15,
   "minimum": 0,
   "description": "Number of children guests"
  },
  "currency": {
   "enum": [
    "USD",
    "AUD",
    "BRL",
    "BGN",
    "BAM",
    "CAD",
    "CLP",
    "CNY",
    "COP",
    "CRC",
    "CZK",
    "DKK",
    "EGP",
    "AED",
    "EUR",
    "GHS",
    "GTQ",
    "HNL",
    "HKD",
    "HUF",
    "INR",
    "IDR",
    "ILS",
    "JPY",
    "KZT",
    "KES",
    "MYR",
    "MXN",
    "MAD",
    "TWD",
    "NZD",
    "NOK",
    "PEN",
    "PHP",
    "PLN",
    "GBP",
    "QAR",
    "RON",
    "RUB",
    "SAR",
    "SGD",
    "ZAR",
    "KRW",
    "SEK",
    "CHF",
    "THB",
    "TRY",
    "UGX",
    "UAH",
    "UYU",
    "VND"
   ],
   "type": "string",
   "default": "USD",
   "description": "Currency code for pricing. Defaults to USD on airbnb.com; country-specific domains use their own local currency unless this parameter is set."
  },
  "amenities": {
   "type": "string",
   "description": "Comma-separated list of amenity keys (e.g., \"wifi,pool,kitchen\"). Supports hundreds of amenities including wifi, pool, kitchen, air_conditioning, heating, washer, dryer, parking, pets_allowed, wheelchair_accessible, gym, hot_tub, ev_charger, and many more. Also supports special filters: guest_favorite, instant_book, luxe."
  },
  "bathrooms": {
   "type": "integer",
   "maximum": 8,
   "minimum": 0,
   "description": "Minimum number of bathrooms"
  },
  "price_max": {
   "type": "integer",
   "minimum": 0,
   "description": "Maximum price filter per night"
  },
  "price_min": {
   
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "error": {
   "type": "string",
   "description": "Error message when no results are found"
  },
  "pagination": {
   "type": "object",
   "properties": {
    "next_page_token": {
     "type": "string",
     "description": "Token to retrieve the next page of results"
    }
   }
  },
  "properties": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "description": "Unique property listing ID"
     },
     "link": {
      "type": "string",
      "description": "URL to property details page"
     },
     "price": {
      "type": "object",
      "properties": {
       "discount": {
        "type": "string",
        "description": "Discount amount display text"
       },
       "breakdown": {
        "type": "array",
        "items": {
         "$ref": "#/components/schemas/youtube_5e7b3be832ec__ResponseBfde03595B3D_PriceBreakdownItem"
        },
        "description": "Every itemized price line: the stay subtotal, any discount lines, any tax or fee lines, and the total. The lines sum to the total, so a listing's taxes are read from here rather than from a single field, since a card can carry several tax lines. Line descriptions are localized to the airbnb_domain."
       },
       "qualifier": {
        "type": "string",
        "description": "Price qualifier text (e.g., per night, per week)"
       },
       "total_price": {
        "type": "string",
        "description": "Total price display text"
       },
       "original_price": {
        "type": "string",
        "description": "Original price before discount"
       },
       "total_with_taxes": {
        "type": "string",
        "description": "Formatted all-in total including taxes and fees. Exact, where `total_price` is Airbnb's rounded display figure. Present only when Airbnb provides an all-in figure, so its absence means no tax-inclusive price was available."
       },
       "extracted_discount": {
        "type": "number",
        "description": "Numeric discount value"
       },
       "extracted_qualifier": {
        "type": "integer",
        "description": "Numeric qualifier value"
       },
       "price_per_qualifier": {
        "type": "string",
        "description": "Price breakdown per qualifier"
       },
       "extracted_total_price": {
        "type": "number",
        "description": "Numeric total price value"
       },
       "extracted_original_price": {
        "type
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-airbnb-listing-search-6518e170/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aisa.one](https://www.zero.xyz/host/api.aisa.one/llms.txt)
