Skip to content

CSN-DTO MediaItem ​

A standardised format for the transfer of media within the automotive industry globally. This is developed and in use by carsales.com Limited and its local and international entities. For more information, please see it's GitHub repo.

Below is a comprehensive overview of each of the parameters that CSN-DTO MediaItem supports, and each type of media they apply to.

Required parameters ​

These are the required parameters within the CSN-DTO MediaItem and its derivities. Requests cannot be completed without these parameters.

NameTypeMediaItemDescription
TypestringAllThe source that the media was created from. Applicable types for media sent via Global Inventory are:
- DEALER
- LESA
- SPIN (videos only)
OrderintAllThe position of the media within a inventory item's media collection. Order can start at either 0 or 1. Defaults to 0 if omitted
Note After the photos are processed, the photo array is zero-indexed.
UrlstringAllAbsolute path of the media to be uploaded. The media item must be accessible on the public internet.

Applicable file extensions for images sent via Global Inventory are:
- .jpg
- .jpeg
- .png

Applicable file extensions for videos sent via Global Inventory are:
- .mp4
- .mov

The file extension requirement applies to standard videos only. It does not apply to a video with Type of SPIN, which only needs a valid absolute URL.

Optional parameters ​

The following are optional parameters supported by CSN-DTO MediaItem.

NameTypeMediaItemDescription
TagsTag[]AllSee the Tags page for details
ThumbUrlstringSpinAbsolute URL of a thumbnail image for the Spin.
ThumbSmallUrlstringSpinAbsolute URL of a small thumbnail image for the Spin.

Examples ​

Below are example MediaItem payloads.

Video ​

{
  "Type": "DEALER",
  "Url": "https://www.learningcontainer.com/wp-content/uploads/2020/05/sample-mp4-file.mp4",
  "Tags": [
    {
        "Name": "SomeName",
        "Value": "SomeValue"
    }
  ]
}

Spin ​

{
  "Type": "SPIN",
  "Url": "https://spins.spincar.com/mydealership/abcd1234video",
  "ThumbUrl": "https://cdn.impel.io/swipetospin-viewers/mydealership/abcd1234video/20260903032350.8IVCADCT/thumb-lg.jpg",
  "ThumbSmallUrl": "https://cdn.impel.io/swipetospin-viewers/mydealership/abcd1234video/20260903032350.8IVCADCT/thumb-lg.jpg"
}

Two Photos ​

[
  {
    "type": "DEALER",
    "url": "https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png?20120323050937",
    "order": 1,
    "tags": [
      {
        "name": "SomeName",
        "value": "SomeValue"
      }
    ]
  },
  {
    "type": "DEALER",
    "url": "https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png?20120323050937",
    "order": 2,
    "tags": [
      {
        "name": "SomeName",
        "value": "SomeValue"
      }
    ]
  }
]