Listing get — Airbnb

airbnb.listing.get

Load Airbnb listing content, reviews, availability and stay pricing

POST /v1/operations/airbnb.listing.get

Headers

Authorization: Bearer YOUR_CONNECTOR_TOKEN
Content-Type: application/json

Inputs

Parameter	Example type	Example value
listing_id	string	"123"
stay	object	{"checkin":"2026-10-04","checkout":"2026-10-07","adults":2,"currency":"GBP"}

Example input

{
  "listing_id": "123",
  "stay": {
    "checkin": "2026-10-04",
    "checkout": "2026-10-07",
    "adults": 2,
    "currency": "GBP"
  }
}

Illustrative response for the example input. Availability, prices and result order vary. Replace example references and URLs with values returned by your own requests.

Example response

{
  "listing_id": "123",
  "search_context": {
    "checkin": "2026-10-04",
    "checkout": "2026-10-07",
    "adults": 2,
    "currency": "GBP"
  },
  "listing": {
    "title": "Example London stay",
    "photos": []
  },
  "deferred": {},
  "booking": {
    "availability": {
      "isAvailable": true
    },
    "structuredDisplayPrice": {
      "primaryLine": {
        "price": "£200",
        "qualifier": "total"
      }
    }
  },
  "availability": {
    "calendar_months": []
  },
  "reviews": {
    "reviews": []
  },
  "reviews_next_cursor": null
}

Open JSON schema

Input schema

{
  "$id": "https://useajar.com/schemas/airbnb/listing-get.input.schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "calendar_months": {
      "maximum": 12,
      "minimum": 1,
      "type": "integer"
    },
    "listing_id": {
      "pattern": "^[0-9]{1,30}$",
      "type": "string"
    },
    "review_limit": {
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "reviews_cursor": {
      "maxLength": 4096,
      "minLength": 1,
      "type": "string"
    },
    "stay": {
      "additionalProperties": false,
      "properties": {
        "adults": {
          "maximum": 16,
          "minimum": 1,
          "type": "integer"
        },
        "checkin": {
          "format": "date",
          "type": "string"
        },
        "checkout": {
          "format": "date",
          "type": "string"
        },
        "children": {
          "maximum": 15,
          "minimum": 0,
          "type": "integer"
        },
        "currency": {
          "description": "Airbnb display currency for prices and price filters; GBP by default. No local currency conversion.",
          "enum": [
            "AED",
            "AUD",
            "BRL",
            "BGN",
            "CAD",
            "CHF",
            "CLP",
            "CNY",
            "COP",
            "CRC",
            "CZK",
            "DKK",
            "EGP",
            "EUR",
            "GBP",
            "GHS",
            "HKD",
            "HUF",
            "IDR",
            "ILS",
            "INR",
            "JPY",
            "KES",
            "KRW",
            "KZT",
            "MAD",
            "MXN",
            "MYR",
            "NOK",
            "NZD",
            "PEN",
            "PLN",
            "PHP",
            "QAR",
            "RON",
            "SAR",
            "SEK",
            "SGD",
            "THB",
            "TRY",
            "TWD",
            "UAH",
            "UGX",
            "USD",
            "UYU",
            "VND",
            "ZAR"
          ],
          "type": "string"
        },
        "infants": {
          "maximum": 5,
          "minimum": 0,
          "type": "integer"
        },
        "pets": {
          "maximum": 5,
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "checkin",
        "checkout"
      ],
      "type": "object"
    }
  },
  "required": [
    "listing_id",
    "stay"
  ],
  "type": "object"
}