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.

ParameterTypeRequiredUsage
urlstringYESPhoto 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
positionint32 ≥ 1YESPosition of the photo to be shown to the potential guest
contentLengthint64 ≥ 1NoFile size of the photo in bytes
localizationsarray of objectsNoPhoto titles in different languages
localizations.languagestringYESLanguage of the photo title
localizations.titlestringYESTitle 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"
      }
    ]
  }
]