> **For AI agents:** this page is a focused, LLM-optimized view of a
> single Fiber AI operation. Before calling it, fetch the routing
> instructions at [`https://api.fiber.ai/llms.txt`](https://api.fiber.ai/llms.txt) and the full operation
> index at [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md).

# bookingProperty

`POST /v1/booking/property`

**Tags:** `Market intelligence`

Get Booking.com property details

**Endpoint:** `https://api.fiber.ai/v1/booking/property`

## Description

Retrieves full details for a single Booking.com property, including amenities, photos, scores, and house rules.

⚡ Rate limit: 120 requests per 1 minute

💰 Cost: 2 credits per property lookup ⓘ

## Request body (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "Your Fiber API key"
    },
    "propertyUrl": {
      "type": "string",
      "pattern": "^https?:\\/\\/(?:www\\.)?booking\\.com\\/hotel\\/(?:[a-z]{2})\\/(?:[a-z0-9-]+)(?:\\.[a-z]{2}(?:-[a-z]{2,4})?)?(?:\\.html)?(?:[?#].*)?$",
      "description": "Full Booking.com property URL (e.g. 'https://www.booking.com/hotel/hr/sumratin-dubrovnik.html'). Obtain it from a result returned by POST /v1/booking/search — pass the `propertyUrl`, not the `propertyId`."
    },
    "languageCode": {
      "type": [
        "string",
        "null"
      ],
      "pattern": "^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$",
      "description": "Language for property names, descriptions, and labels. Pass a BCP-47 language tag such as 'en', 'en-US', 'fr', 'de', or 'es'. Omit for English."
    }
  },
  "required": [
    "apiKey",
    "propertyUrl"
  ]
}
```

## Response — success (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "output": {
      "type": "object",
      "properties": {
        "property": {
          "type": "object",
          "properties": {
            "propertyId": {
              "type": "string",
              "description": "Booking.com property identifier."
            },
            "name": {
              "type": "string",
              "description": "Property display name."
            },
            "propertyUrl": {
              "type": "string",
              "description": "Full Booking.com property URL. Pass as `propertyUrl` in POST /v1/booking/property."
            },
            "address": {
              "type": [
                "string",
                "null"
              ],
              "description": "Street address."
            },
            "city": {
              "type": [
                "string",
                "null"
              ],
              "description": "City name."
            },
            "district": {
              "type": [
                "string",
                "null"
              ],
              "description": "District or neighborhood."
            },
            "countryCode": {
              "type": [
                "string",
                "null"
              ],
              "description": "ISO 3166-1 alpha-3 country code (e.g. 'USA')."
            },
            "coordinates": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "latitude": {
                  "type": "number",
                  "description": "Latitude in decimal degrees."
                },
                "longitude": {
                  "type": "number",
                  "description": "Longitude in decimal degrees."
                }
              },
              "required": [
                "latitude",
                "longitude"
              ],
              "description": "Geographic coordinates of the property in decimal degrees."
            },
            "hotelStarClass": {
              "type": [
                "integer",
                "null"
              ],
              "minimum": 1,
              "maximum": 5,
              "description": "Hotel star class from 1 to 5, indicating how upscale the property is. This is a property classification, not a guest review score."
            },
            "reviewScore": {
              "type": [
                "number",
                "null"
              ],
              "minimum": 0,
              "maximum": 10,
              "description": "Guest review score from 0 to 10."
            },
            "reviewCount": {
              "type": [
                "integer",
                "null"
              ],
              "description": "Total number of guest reviews."
            },
            "thumbnailUrl": {
              "type": [
                "string",
                "null"
              ],
              "description": "Thumbnail image URL."
            },
            "isPreferred": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "True when the property belongs to Booking.com's Preferred Partner programme, which promotes it in Booking.com's own result ranking."
            },
            "description": {
              "type": [
                "string",
                "null"
              ],
              "description": "Property description."
            },
            "accommodationType": {
              "type": [
                "string",
                "null"
              ],
              "description": "Accommodation type (e.g. 'hotel', 'guestHouse')."
            },
            "amenities": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Amenities offered by this property."
            },
            "photoUrls": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Property photo URLs."
            },
            "languagesSpoken": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "BCP-47 language tags for the languages property staff speak (e.g. ['en', 'hr', 'pt-BR'])."
            },
            "checkInTime": {
              "type": [
                "string",
                "null"
              ],
              "description": "Check-in time in 24-hour `HH:mm` format, where `HH` is 00 through 23 (e.g. '15:00')."
            },
            "checkOutTime": {
              "type": [
                "string",
                "null"
              ],
              "description": "Check-out time in 24-hour `HH:mm` format, where `HH` is 00 through 23 (e.g. '11:00')."
            },
            "scoreBreakdown": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "staff": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "minimum": 0,
                  "maximum": 10,
                  "description": "Staff score from 0 to 10."
                },
                "facilities": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "minimum": 0,
                  "maximum": 10,
                  "description": "Facilities score from 0 to 10."
                },
                "cleanliness": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "minimum": 0,
                  "maximum": 10,
                  "description": "Cleanliness score from 0 to 10."
                },
                "comfort": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "minimum": 0,
                  "maximum": 10,
                  "description": "Comfort score from 0 to 10."
                },
                "value": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "minimum": 0,
                  "maximum": 10,
                  "description": "Value-for-money score from 0 to 10."
                },
                "location": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "minimum": 0,
                  "maximum": 10,
                  "description": "Location score from 0 to 10."
                },
                "breakfast": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "minimum": 0,
                  "maximum": 10,
                  "description": "Breakfast score from 0 to 10."
                },
                "wifi": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "minimum": 0,
                  "maximum": 10,
                  "description": "Wi-Fi score from 0 to 10."
                }
              },
              "description": "Guest review scores by category, each from 0 to 10."
            },
            "houseRules": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "ageRestriction": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Age restriction policy, when published."
                },
                "childrenPolicy": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Children policy, when published."
                },
                "petsPolicy": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Pets policy, when published."
                },
                "smokingPolicy": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Smoking policy, when published."
                },
                "partiesPolicy": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Parties and events policy, when published."
                },
                "groupPolicy": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Group booking policy, when published."
                },
                "paymentMethods": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Accepted payment methods."
                },
                "isCashAccepted": {
                  "type": [
                    "boolean",
                    "null"
                  ],
                  "description": "True when the property accepts cash."
                }
              },
              "required": [
                "paymentMethods"
              ],
              "description": "Published house rules for the property."
            },
            "isSustainable": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "True when the property is marked as a sustainable stay."
            }
          },
          "required": [
            "propertyId",
            "name",
            "propertyUrl",
            "amenities",
            "photoUrls",
            "languagesSpoken"
          ],
          "description": "Full property details including amenities, photos, and house rules."
        }
      },
      "required": [
        "property"
      ]
    },
    "chargeInfo": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-now"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged"
          ],
          "description": "Credits were charged immediately for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charging-later"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "Credits will be charged after the operation completes"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-for-async-process"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged",
            "message"
          ],
          "description": "Credits that were charged for an asynchronous operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "free"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "No credits were charged for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "credits-refunded"
              ]
            },
            "creditsRefunded": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsRefunded",
            "message"
          ],
          "description": "Credits were refunded for this operation"
        }
      ]
    },
    "warnings": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "description": "Full path to extraneous field (e.g., 'searchParams.ExtraField')"
          },
          "message": {
            "type": "string",
            "description": "Warning message"
          }
        },
        "required": [
          "field",
          "message"
        ]
      },
      "description": "Warnings about extraneous fields in request"
    },
    "advice": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "Tips, recommendations, and suggestions for using this API effectively."
    }
  },
  "required": [
    "output",
    "chargeInfo"
  ],
  "additionalProperties": false
}
```

---

Canonical JSON: [`https://api.fiber.ai/openapi.json`](https://api.fiber.ai/openapi.json)
Operation index: [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md)