Airbnb · Schema

ListingCreate

Properties

Name Type Description
name string The display name of the listing.
description string The full description of the property.
property_type string The type of property being listed.
room_type string The type of room or space being offered.
address object
bedrooms integer The number of bedrooms in the property.
bathrooms number The number of bathrooms in the property.
beds integer The total number of beds in the property.
max_guests integer The maximum number of guests allowed.
amenities array The list of amenity identifiers available at the property.
house_rules string The house rules and guidelines for guests.
check_in_time string The earliest check-in time in HH:MM format.
check_out_time string The latest check-out time in HH:MM format.
cancellation_policy string The cancellation policy applied to the listing.
View JSON Schema on GitHub

JSON Schema

airbnb-listing-create-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/airbnb/refs/heads/main/json-schema/airbnb-listing-create-schema.json",
  "title": "ListingCreate",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The display name of the listing.",
      "maxLength": 50
    },
    "description": {
      "type": "string",
      "description": "The full description of the property.",
      "maxLength": 5000
    },
    "property_type": {
      "type": "string",
      "description": "The type of property being listed.",
      "enum": [
        "apartment",
        "house",
        "secondary_unit",
        "unique_space",
        "bed_and_breakfast",
        "boutique_hotel"
      ]
    },
    "room_type": {
      "type": "string",
      "description": "The type of room or space being offered.",
      "enum": [
        "entire_home",
        "private_room",
        "shared_room"
      ]
    },
    "address": {
      "$ref": "#/components/schemas/Address"
    },
    "bedrooms": {
      "type": "integer",
      "description": "The number of bedrooms in the property.",
      "minimum": 0
    },
    "bathrooms": {
      "type": "number",
      "description": "The number of bathrooms in the property.",
      "minimum": 0
    },
    "beds": {
      "type": "integer",
      "description": "The total number of beds in the property.",
      "minimum": 0
    },
    "max_guests": {
      "type": "integer",
      "description": "The maximum number of guests allowed.",
      "minimum": 1
    },
    "amenities": {
      "type": "array",
      "description": "The list of amenity identifiers available at the property.",
      "items": {
        "type": "string"
      }
    },
    "house_rules": {
      "type": "string",
      "description": "The house rules and guidelines for guests."
    },
    "check_in_time": {
      "type": "string",
      "description": "The earliest check-in time in HH:MM format.",
      "pattern": "^[0-2][0-9]:[0-5][0-9]$"
    },
    "check_out_time": {
      "type": "string",
      "description": "The latest check-out time in HH:MM format.",
      "pattern": "^[0-2][0-9]:[0-5][0-9]$"
    },
    "cancellation_policy": {
      "type": "string",
      "description": "The cancellation policy applied to the listing.",
      "enum": [
        "flexible",
        "moderate",
        "strict",
        "strict_14_with_grace_period",
        "super_strict_30",
        "super_strict_60"
      ]
    }
  },
  "required": [
    "name",
    "property_type",
    "room_type",
    "address",
    "max_guests"
  ]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/airbnb-listing-create"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.