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!
- 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, push the complete list of current photos every time: photos missing from the list are removed, and an empty list removes all photos of the parent listing, which every unit shows. Pushing the same URLs again restores removed photos.
- 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 |
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 |
Responses can also include contentLength: the file size in bytes reported by Holidu's photo download. It is missing until Holidu has downloaded the photo and is never returned in the sandbox. Do not send it: photos are matched by URL, so publish a changed image under a new URL.
PHOTOS JSON object
[
{
"url": "https://example.com/photos/pool.jpg",
"position": 1,
"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,
"localizations": [
{
"language": "en",
"title": "Fitness Center"
},
{
"language": "de",
"title": "Fitnesszentrum"
},
{
"language": "fr",
"title": "Centre de Fitness"
}
]
}
]