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.
You must have the following:
- A property ID by completing step 2 successfully.
- A unit ID by completing step 3 successfully.
POST
https://supply-xml.booking.com/photo-api/properties/{{propertyID}}/pending/photosEach 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
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 |
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. |
The following is a request body example:
{
"photos": [
{
"url":"https://cdn.pixabay.com/photo/2024/01/11/16/29/leaves-8502135_1280.jpg"
}
]
}The following is a successful response body example:
{
"data": {
"photo_batch_id": "u9Ov9gu9NBc"
},
"errors": [],
"warnings": [],
"meta": {
"ruid": "XXXXXXXXXXXXXXXXXXXXXXXXX"
}
}