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:
Element | Description | Type | Required/ Optional | Notes |
---|---|---|---|---|
propertyID | Specifies the unique ID of the property. | integer | required |
Request body parameters
The following table describes the elements you can add in the request body:
All parameters are required unless otherwise noted.
Parameter | Description |
---|---|
photos | Contains photo objects. The maximum number of photos you can upload per property is 299. |
> url | Specifies 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"
}
}