Last updated

Step 11 - Add property photos

Use the Photos API to add photos of the property. By default, the Photos API adds the first uploaded photo as the main photo. It takes several minutes for the photo to appear in the Booking.com system.

Prerequisites

You must have the following:

  • A property ID by completing step 2 successfully.
  • A unit ID by completing step 3 successfully.

Adding property photos

POST
https://supply-xml.booking.com/photo-api/properties/{{propertyID}}/pending/photos

Photo requirements

Each photo that you upload must meet the following requirements:

  • Minimum dimensions: 300 x 300 pixels
  • Maximum dimensions: 14000 x 14000 pixels
  • Maximum file size: 50000000 bytes or 50 megabyte

Path parameters

The following table describes the elements you must specify in the path:

ElementDescriptionTypeRequired/
Optional
Notes
propertyIDSpecifies the unique ID of the property.integerrequired

Request body parameters

The following table describes the elements you can add in the request body:

All parameters are required unless otherwise noted.

ParameterDescription
photosContains photo objects. The maximum number of photos you can upload per property is 299.
> urlSpecifies the URL of the photo.

Request body example

The following is a request body example:

{
  "photos": [
    {
      "url":"https://cdn.pixabay.com/photo/2024/01/11/16/29/leaves-8502135_1280.jpg"
    }
  ]
}

Response body example

The following is a successful response body example:

{
  "data": {
      "photo_batch_id": "u9Ov9gu9NBc"
  },
  "errors": [],
  "warnings": [],
  "meta": {
      "ruid": "XXXXXXXXXXXXXXXXXXXXXXXXX"
  }
}