A Multi-Unit Parent Listing Photos
The Parent Listing Photos Endpoint is designed to manage and update visual content for parent multi-unit properties, such as holiday parks, hotels, guest houses, and similar establishments. This endpoint focuses on showcasing the entire compound or establishment, including its facilities and shared amenities, rather than individual property-level details.
Show us your compound!
Photos basics
- We highly recommend to have at least 10 photos for a better performance.
- To update a photo, please push it with a different url, only then it will be recognized as a new photo and then it will be updated. To do so, you can include a param + the timestamp of when the photo was updated to the URL.
- To update or delete photos, please repush the entire list of current photo objects. Photos can be deleted, but only by pushing new photos. An empty list of photos is ignored.
- When pushing photos to our photos endpoint, it is important to include a filter to eliminate duplicate URLs. Duplicate URLs within a photo push request will lead to a failure of the entire request. Therefore, ensuring that each URL is unique helps maintain the integrity of the photo push process and prevents potential issues with data ingestion.
Ideally the photos should have a size of 2MB. To make sure everything runs smoothly, they should not be larger than 8MB.
Parameter | Type | Required | Usage |
---|---|---|---|
url | string | YES | Photo URL Recommendations: - ideal resolution 2048x1536 pixels - min resolution 1024x683 pixels - ideal size: 2MB, no larger than 8MB - orientation: landscape - formats: JPG, JPEG, PNG - no photo duplications |
position | int32 ≥ 1 | YES | Position of the photo to be shown to the potential guest |
contentLength | int64 ≥ 1 | No | File size of the photo in bytes |
localizations | array of objects | No | Photo titles in different languages |
localizations.language | string | YES | Language of the photo title |
localizations.title | string | YES | Title of the photo |
PHOTOS JSON object
[
{
"url": "https://example.com/photos/pool.jpg",
"position": 1,
"contentLength": 2048000,
"localizations": [
{
"language": "en",
"title": "Outdoor Pool"
},
{
"language": "de",
"title": "Außenpool"
},
{
"language": "fr",
"title": "Piscine Extérieure"
}
]
},
{
"url": "https://example.com/photos/gym.jpg",
"position": 2,
"contentLength": 3072000,
"localizations": [
{
"language": "en",
"title": "Fitness Center"
},
{
"language": "de",
"title": "Fitnesszentrum"
},
{
"language": "fr",
"title": "Centre de Fitness"
}
]
}
]
Updated about 13 hours ago