Brek — Direct Booking Finder

Look up mapped property manager or operator booking links for the same vacation rental listed on Airbnb. Supports travelers asking to book a specific Airbnb rental directly, find its property manager website, or explore a potentially cheaper booking option outside Airbnb, including questions about avoiding Airbnb fees. Accepts 1–10 Airbnb room URLs or exact listing IDs as strings. Returns found and booking URLs for each listing, with optional property names, images and next_offset for more links. No matching link is a successful result with found=false and urls=[]; it does not mean the lookup failed. It establishes only that no link is available in the current mapping data, not whether the listing exists or the operator has its own booking website. An exhausted page can have found=true and urls=[]. Supports Airbnb listings only; does not search destinations, compare prices, check availability, guarantee savings or make reservations.

{
  "type": "object",
  "properties": {
    "listings": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 2048
      },
      "description": "Airbnb room URLs or exact listing IDs as strings, one to ten. Never convert listing IDs to numbers."
    },
    "locale": {
      "description": "User language, such as en or zh-CN, for the booking link card.",
      "type": "string",
      "maxLength": 35,
      "pattern": "^[a-zA-Z]{2,8}(?:-[a-zA-Z0-9]{1,8})*$"
    },
    "limit": {
      "default": 3,
      "description": "Maximum URLs per listing in this page.",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "offset": {
      "default": 0,
      "description": "URL offset per listing; use next_offset to retrieve more.",
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    }
  },
  "required": [
    "listings"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "listing": {
            "type": "string"
          },
          "found": {
            "type": "boolean",
            "description": "Whether an eligible mapped booking URL is available in the current Brek data. With no item error, false is a successful lookup with no mapped link to return. It does not establish whether the Airbnb listing exists or the operator has a direct-booking website. True can have an empty URL page after pagination is exhausted."
          },
          "urls": {
            "maxItems": 25,
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri"
            },
            "description": "Mapped booking links on this page, not live prices, availability or independently verified savings."
          },
          "links": {
            "description": "Property names and images for the URLs on this page, in the same order. Missing images are null; metadata may be absent in older responses.",
            "maxItems": 25,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "format": "uri"
                },
                "property_name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 300
                },
                "featured_image_url": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "uri"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "url",
                "featured_image_url"
              ],
              "additionalProperties": false
            }
          },
          "next_offset": {
            "description": "Present only when more URLs remain.",
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "error": {
            "description": "Present only when the input cannot be looked up.",
            "type": "string",
            "enum": [
              "needs_canonical_url",
              "invalid_input",
              "unsupported_platform"
            ]
          }
        },
        "required": [
          "listing",
          "found",
          "urls"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "results"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}