Media and RETS
RETS accesses the media servers on the NTREIS MLS System. Media added to the MLS system is immediately available to RETS users.
10.a) Media Look Up Tool
NTREIS provides a tool for verifying the media exists on the Media Servers. Use this link:
http://ntreis.net/documents/MediaLookup.asp
and enter the MLS Number. The results will display all the media as it exists on both NTREIS servers that store media.
10.b) Working with MEDIA
Every listing has a MLS Number and UID in the Property Class. The UID in each Property Class links to the TableUID in the Media class. In addition, there is a UID in the Media class.
You can download media from the media servers using “GetObject” and the MLS Number or you can link to the media on the NTREIS MLS media servers. Currently, the media is 300GB (and growing) in size. By linking to the media as opposed to downloading the actual files, you will minimize the amount of space you need for storage and not have to manage the media files. Linking to the media also decreases the amount of bandwidth needed, allowing for better performance by all. Linking to the media on the NTREIS Media Servers may be the optimal way to access the media.
Although the Media Class on the NTREIS RETS Server does not contain the URL’s, you can create a URL by either:
You would then use this URL as a link that will access the images on the media server.
To download the URL’s use “Location=1” in your RETS client, or if you are using the MarketLinx RETS Connector client, Under the MEDIA tab, check “Add Locations to Data File”.

If you wish to generate your own URL’s, follow the instructions below:
To start with an example, these are the URL’s for the low and high resolution images for MLS Number 9143317:
http://ntreispictures.marketlinx.com/MediaDisplay/86/HR769086-1.jpg
http://ntreispictures.marketlinx.com/MediaDisplay/86/LR769086-1.jpg
Pasting these into your browser will display the images for this property. The URL consists of:
1) “http://ntreispictures.marketlinx.com/MediaDisplay/”
2) the last two digits of the TableUID,
3) “/HR/” for high resolution media or “/LR/” for low resolution media; and
4) the MEDIASOURCE
Below is an example SQL Script you can use to generate the media URL’s. You would modify this as necessary to insert the URL into your media table.
select
'http://ntreispictures.marketlinx.com/MediaDisplay/' + RIGHT(TableUID, 2)
+ '/HR' + MEDIASOURCE,
'http://ntreispictures.marketlinx.com/MediaDisplay/' + RIGHT(TableUID, 2)
+ '/LR' + MEDIASOURCE
For reference, a similar script was run on the MLS Data that returned the MLSNUM, TableUID, MEDIASOURCE, and the generated High Res URL. The results are below
|
MLSNum |
TableUID |
Media Source |
High Res URL |
|
10442368 |
2019637 |
2019637-9.jpg |
http://ntreispictures.marketlinx.com/MediaDisplay/37/hr2019637-9.jpg |
|
10442368 |
2019637 |
2019637-8.jpg |
http://ntreispictures.marketlinx.com/MediaDisplay/37/hr2019637-8.jpg |
|
10442368 |
2019637 |
2019637-1.jpg |
http://ntreispictures.marketlinx.com/MediaDisplay/37/hr2019637-1.jpg |
10.b) Deleting Media Files
The MarketLinx Tempo MLS System changes the PHOTODATE whenever any media is modified, added, or deleted. The PHOTODATE does not update if display order is changed. A more descriptive name may have been "MediaDate" and not "PhotoDate".
10.c) Media Types
There are seven MEDIATYPES in the Media Class:
Pic |
Indicates the media is a picture |
Vt |
Indicates the media is a virtual tour |
Url |
Indicates the media is a URL |
Rtf |
Indicates the media is a .rtf |
Txt |
Indicates the media is a .txt |
Indicates the media is a .pdf |
|
Fax |
Indicates the media is a fax |
Ppvt |
Indicates the media is a Property Panorama Virtual Tour |
Ppss |
Indicates the media is a Property Panorama Slideshow |
Per NTREIS Rules and Regulations, the media type, “URL” should never be displayed on an Internet website that faces the public. NTREIS monitors the media type, “vt”, to ensure no contact information is present anywhere on the information displayed by the media type “vt”.
The media type, “URL” is not monitored. You may not wish to use the media type, “URL”, as it often contains the contact information for the listing agent and or office. NTREIS suggests you give careful thought to using the media type ”URL”.
10.d) Media Fields Definitions
Below is a list of the fields associated with media.
|
SystemName |
RETS Class |
Definition |
|
MLSNUM |
RES, MUL, LND, COM, LSE |
MLS Number |
|
UID |
RES, MUL, LND, COM, LSE |
Ties to the Table UID in the MEDIA Class. |
|
MODIFIED |
Updates when Listing Data is added or modified and when any Media is modified/added/deleted. Will not update if display order is changed |
|
|
PHOTODATE |
RES, MUL, LND, COM, LSE |
Updates whenever any media is modified/added/deleted. PHOTODATE will not update if display order is changed. Better name may have been "MediaDate" and not "PhotoDate". |
|
PHOTOCOUNT |
RES, MUL, LND, COM, LSE |
Number of images currently associated with the listing. |
|
DISPLAYORDER |
Media |
System generated. Numbers may not be consecutive. |
|
INPUTDATE |
Media |
Date media record is created. INPUTDATE is populated when a media record is created (any type). |
|
MEDIADESCR |
Media |
Media Description |
|
MEDIANAME |
Media |
Media Name |
|
MEDIASOURCE |
Media |
For virtual tour, MediaSource is the virtual tour URL; for pics it is the <tableuid>.<displayorder>.jpg. When the MLS user changes the order of the images in MLS, the DisplayOrder changes, but the MediaSource does not change. |
|
MEDIATYPE |
Media |
Media Types – Pic (jpg Image), Vt (virtual tour), Url, Rtf (rich text format), Txt, Pdf, Fax, ppvt (Property Panorama Virtual Tour), ppss (Property Panorama Slideshow) |
|
MODIFIED |
Media |
Media modified date Is populated when a record (photo, url, attachment etc) is entered, then updated if any changes (display order, description added) to that particular record are made, or any media is added (does not update if a record is deleted) |
|
PICCOUNT |
Media |
PicCount is the number of images that have historically been associated with the listing. |
|
PRIMARYPIC |
Media |
Media primary picture. The PrimaryPic is not always the lowest number for DisplayOrder. |
|
TABLEUID |
Media |
Ties to the UID in the Property Classes. |
|
UID |
Media |
Unique ID for each record in the MEDIA Class |
RTF, TXT, PDF, and FAX MEDIATYPEs are not available for users who download data for a public facing website.
The “NTREIS Media Examples” on the RETS Technical Support page, http://www.ntreis.net/documents/NTREISRETS_9122009112539.xls
contains actual data from the MLS System showing the relationship of the fields listed above.
Updated: 6/3/2011