Manage media of a classified

Status: Live 🟢 Market: 🇫🇷

Executive Summary

• Goal: Display pictures, videos, virtual tour, … on associated classified.
• Value Proposition: First picture helps increase conversion rate on search list.
• Ideal for: all classifieds.

The Integration Workflow

Step 1: Providing the ordered list

• Logic: Send all media of associated classified at once. Media will be displayed on our portals in the very same order of this list.
• Technical Link: This can be performed either on POST Classified or PUT Classified.

Step 2: Qualification

• Logic: Virtual tours and videos are displayed separately from the pictures on our portals. Only the first virtual tour will be displayed. Only the first video will be displayed.

Step 3: Updating media

• Logic: Whenever a media needs to be added or removed from a classified, full classified has to be updated through PUT Classified with the media list updated accordingly.
  • Any already provided media will be downloaded again only when its timestamp is different.
  • Any already provided media will be reordered only if its place has changed from the previous version.
  • Any media removed from the previous version will be removed from the classified.
  • Any media added from the previous version will be downloaded and added to the classified.

Step 4: Send a stable media update

• Logic: Please, consider sending us a consolidated update of a classified and its media.
  • As users may change several pictures, send us a unique API call that will sum up all these changes at once.
  • If no media has changed then retain from sending us an update.

The “Golden Path” Implementation

{
  "media": [
    {
      "category": "LIVING_ROOM",
      "mediaType": "PICTURE",
      "tags": [
        "LIVING_ROOM"
      ],
      "title": "Double living room",
      "url": "http://a.com/a.jpg&timestamp=2026-02-13T09:25:57"
    },
    {
      "category": "COVER_PICTURE",
      "mediaType": "PICTURE",
      "tags": [
        "COVER_PICTURE"
      ],
      "title": "Cover",
      "url": "http://a.com/a.jpg&timestamp=2026-02-13T09:25:57"
    }
  ]
}

Error Handling (The “Sad Path”)

Resources

• Full API Reference: French API V4