Property Manager RSS Feeds
- Are you a landlord or property manager with many units for rent?
- Do you want an easy way to list your available rentals on MoveFrog.com every day?
- Do you want to be able to automatically keep your MoveFrog listings up to date?
Our property manager listing feed is based on the RSS 2.0 XML format. This is the standard format used for data publication and broadcasting on the Internet today. It is used by podcasters, media outlets, and other such organizations who regularly publish data to the Internet. As a property manager, you have data (vacancy listings) to publish, and this standard, along with the MoveFrog enhancements explained below, is an excellent way to do it. For more information about RSS, please review this article: RSS 2.0 at Harvard Law
In order to publish your feed to MoveFrog.com, you will need to meet the following requirements:
- The ability to create a valid XML file in the appropriate format, using your existing database and systems. We are not able to provide support for all systems. This document explains the XML format, elements, and acceptable values, but does not explain generation of the file. Please consult with your IT professional about how to produce this file.
- The ability to publish your feed to publicly available URL. Your file must be available at an http:// or https:// address for our system to periodically check it and update your listings.
MoveFrog.com Property Manager Feed Creation
Section 1: Compatibility with Google Base
We know that many property managers are already using the Google Base system to advertise their listings. For this reason, we have based our own XML format on the Google Base RSS 2.0 format.In fact, a Google Base file could be used with no alteration to advertise on MoveFrog.com. If you have an existing Google Base RSS 2.0 feed, you may use that feed address to list on MoveFrog.com. However, the MoveFrog file format offers several additional features that will make it a better choice for most property managers. If you have already created a Google Base feed, it should be very easy to adapt it and expand upon it to create a separate MoveFrog feed using the MoveFrog format.
Besides all of the additional elements used in the MoveFrog format, there are a couple of significant differences that should be pointed out:
- <g:location> vs. <mf:address> / <mf:city> / <mf:zipcode>
Google uses a single element to specify the address of the listing. The MoveFrog.com format uses three elements that are used to place your listing in the correct neighborhood in our listings. Of these, only the <mf:zipcode> element is required. The <mf:city> element can be used to clarify the exact location of the listing. The <mf:address> element is optional, since on MoveFrog, you can choose not to display the exact location of you vacancy. For more information on these elements, see the table of elements below.
- <g:feature> vs. <mf:feature>
Google will accept any value in their feature elements and displays them as text. The MoveFrog format uses the feature elements to create a searchable list of the amenities and features of your listing, so the value of the <mf:feature> elements must be pulled from the list of available values. Any values that do not match an option from the list will be disregarded. See below for more information.
Section 2: Example Minimal File
Below is a sample document containing a single listing. This file includes the minimum required elements.
<?xml version="1.0"?>
<rss version="2.0" xmlns:mf="http://www.movefrog.com/ns/1.0">
<channel>
</rss>
The first two lines specify that this is an XML document using the RSS 2.0 standard. The xmlns:mf specification in the second line specifies the namespace for the elements that are specific to the MoveFrog feed format and begin with "mf:".
<rss version="2.0" xmlns:mf="http://www.movefrog.com/ns/1.0">
<channel>
<title>Your Company's Listings</title>
<link>http://www.your-site.com/movefrog-feed.xml</link>
<description>A data feed for adding rental listings to MoveFrog.com</description>
<item>
</channel><link>http://www.your-site.com/movefrog-feed.xml</link>
<description>A data feed for adding rental listings to MoveFrog.com</description>
<item>
<title>Spacious 2 Bedroom House</title>
<description>This 2 bedroom, 2 1/2 bath single-family house has all new appliances, new carpets, new paint, ceiling fans, network wiring throughout. Close to schools, shopping, and restaurants. Just 10 minutes from the beach and 15 minutes to downtown businesses.</description>
<mf:bathrooms>2.5</mf:bathrooms>
<mf:bedrooms>2</mf:bedrooms>
<mf:zipcode>90503</mf:zipcode>
<mf:price>1750</mf:price>
</item><description>This 2 bedroom, 2 1/2 bath single-family house has all new appliances, new carpets, new paint, ceiling fans, network wiring throughout. Close to schools, shopping, and restaurants. Just 10 minutes from the beach and 15 minutes to downtown businesses.</description>
<mf:bathrooms>2.5</mf:bathrooms>
<mf:bedrooms>2</mf:bedrooms>
<mf:zipcode>90503</mf:zipcode>
<mf:price>1750</mf:price>
</rss>
The "channel" element, which wraps the rest of the RSS document holds one or more "item" elements. Each of these items represnts a listing and contains elements that specifies the details of the listing.
Section 3: Available Elements and Values
| title |
|---|
| Required Element |
|
Headline that will appear at the top of the listing Max: 80 characters Format: text Example: <title>Beautiful two story 3 bedroom house</title> |
| description |
| Required Element |
|
The main text body of the listing. This text will also be used to try to extrapolate additional data points (amenities, building type, etc.) that may not be specified. Max: 1,600 characters Format: text Example: <description>This 3 bedroom, 2 1/2 bath single-family house has all new appliances, new carpets, new paint, ceiling fans, network wiring throughout. Close to schools, shopping, and restaurants. Just 10 minutes from the beach and 15 minutes to downtown businesses.</description>
|
| bathrooms |
| Required Element |
|
The number of bathrooms in the rental. For roommate listings, this should say 1 for a private bathroom or 0 for a shared bathroom Format: number Example: <mf:bathrooms>2.5</mf:bathrooms> |
| bedrooms |
| Required Element |
|
The number of bedrooms in the rental. For roommate listings, this should say 1 for a private bedroom or 0 for a shared bedroom Format: number Example: <mf:bedrooms>3</mf:bedrooms> |
| id |
|
This is your unique identifer for this listing. While this is not a required field, it is a good idea to include this. When your listings are updated every day, if there is no unique ID for the listing, it will be re-created. If there is an ID, then the listing will be updated with any new information. This field must be unique for any listing included and once an ID is used for a rental, it should not be used again for a different rental. Format: text Example: <mf:id>1234-A7</mf:id> |
| image_link |
|
You may include up to five <mf:image_link>...</mf:image_link> elements in each listing. Each one should contain a URL of a photo or diagram of the listing. The URL must start with http:// or https:// Format: url Example:
<mf:image_link>http://www.my-site.com/photos/nice-house-exterior.jpg</mf:image_link>
<mf:image_link>http://www.my-site.com/photos/nice-house-kitchen.jpg</mf:image_link> |
| listing_status |
|
This is the status of the listing. This field is mainly used for compatibility with the Google Base system. Any value except "active" will remove the listing from MoveFrog Format: text Example: <mf:listing_status>active</mf:listing_status> Default: active |
| listing_type |
|
The type of listing Values:
Format: text Example: <mf:listing_type>for rent</mf:listing_type> Default: for rent |
| location |
|
Full address Note: This element is deprecated, please use address and zipcode elements Format: text Example: <mf:location>1234 Broadway Avenue, Springbrook, WI 54875</mf:location> |
| price |
| Required Element |
|
The rent price, in dollars for the given price_term Format: number Example: <mf:price>1750.00</mf:price> |
| property_type |
|
The specific type of rental being advertised Values:
Format: text Example: <mf:property_type>house</mf:property_type> Default: apartment |
| lister_class |
|
The type of party advertising the property Values:
Format: text Example: <mf:lister_class>nofee</mf:lister_class> Default: owner |
| agent |
|
The contact name to be displayed on the listing Format: text Example: <mf:agent>Dale Cooper</mf:agent> Default: (None) - If no value is specified, the contact name will not be listed |
| area |
|
The square footage - only numbers will be processed. Unit is assumed to be square feet. Format: text Example: <mf:area>1450 square feet</mf:area> Default: (None) - If no value is specified, the square footage will not be listed |
| expiration_date |
|
The date that the listing will be removed from the site Format: YYYY-MM-DD ISO 8601 format Example: <mf:expiration_date>2008-12-11</mf:expiration_date> Default: 21 days after the listing date or 21 days after today, whichever is later |
| feature |
|
An amenity or feature of the rental, selected from the list of values below. You may include as many features as required n each listing. Each different feature should be contained in its own <mf:feature>...</mf:feature> element Values:
Format: text Example:
<mf:feature>Satellite TV Paid</mf:feature>
<mf:feature>Patio</mf:feature> <mf:feature>Central Air</mf:feature> |
| listing_date |
|
The date that the listing will appear on the site. This may be a future date for listings that you do not want to list immediately. Format: YYYY-MM-DD ISO 8601 format Example: <mf:listing_date>2008-11-20</mf:listing_date> Default: Today |
| agent_phone |
|
The contact phone number to display Format: text Example: <mf:agent_phone>310-555-5248</mf:agent_phone> Default: (None) - If left blank, no phone number will display |
| agent_email |
|
The contact email address where renters can contact you. This can be anonymized using the emailtype element. Format: text Example: <mf:agent_email>my-rentals@my-address.com</mf:agent_email> Default: (None) - If left blank, no phone number will display |
| emailtype |
|
The email address to display on the listing Values:
Format: text Example: <mf:emailtype>normal</mf:emailtype> Default: normal |
| address |
|
Number and street name of address Format: text Example: <mf:address>1234 Broadway Avenue</mf:address> Default: (None) - If no address is given, the alterate address text will be displayed and the listing will be located in the center of the zip code. Note: Please include an address for all listings, even if you choose to display alternative address data using the show_alt_address and alt_address elements. This way, we will be able to map the listing accurately. If you choose to display alternate address information, the map will be displayed with a circle defining the general area where the listing is located. |
| unitNumber |
|
Unit number for this listing - can be hidden with show_unitnumber field Format: text Example: <mf:unitNumber>B</mf:unitNumber> Default: (None) - If no unit number is given, none will be displayed |
| floorNumber |
|
The floor number this unit is on Format: number Example: <mf:floorNumber>2</mf:floorNumber> Default: (None) - If no floor number is given, none will be displayed |
| show_unitnumber |
|
Show the unit number on the listing or not Values:
Format: boolean Example: <mf:show_unitnumber>false</mf:show_unitnumber> Default: true |
| zipcode |
| Required Element |
|
5-digit zip code of this listing Format: text Example: <mf:zipcode>54875</mf:zipcode> |
| city |
|
City, town, or neighborhood name Note: The actual town name on listing will be determined with the zipcode. This field will help in decision if there is more than one appropriate neighborhood name in the same zip code, but if the city name listed here does not match the zip code provided, then the default city for that zip code will be used. Format: text Example: <mf:city>Springbrook</mf:city> Default: This will automatically default to the default town name for the zip code provided. If there are multiple town names in teh given zip code, this field will be used to identify the correct one to display. If this element does not match one of the appropriate town names for the zip code, the default town name for the zip code will be used. This field cannot be used to advertise a vacancy in a neighborhood it is not actually in. |
| alt_address |
|
Alternate text to display in address area if you do not want to display the actual address Format: text Example: <mf:alt_address>Fourth Street and Main</mf:alt_address> Default: If show_alt_address is true and this field is blank or not present, the address will appear as "(Town name) - Call or Email for Address" |
| show_alt_address |
|
Show the alt_address instead of the actual address Values:
Format: boolean Example: <mf:show_alt_address>true</mf:show_alt_address> Default: False |
| price_term |
|
The length of time the listed price applies to Values:
Format: text Example: <mf:price_term>week</mf:price_term> Default: month |
| available_date |
|
The date that the listed rental will be available for move-in Format: YYYY-MM-DD ISO 8601 format Example: <mf:available_date>2008-12-01</mf:available_date> Default: (None) - If this field is blank or not present, no availability date will be displayed. |
| furnished |
|
Is the rental furnished or not? Values:
Format: text Example: <mf:furnished>Unfurnished</mf:furnished> Default: (None) - If no value is provided, none will be displayed |
| lease_term |
|
The term of the lease Values:
Format: text Example: <mf:lease_term>One Year</mf:lease_term> Default: (None) If no value is specified for lease_term, the lease_term will not be listed |
| dogs |
|
The policy toward keeping dogs in the rental Values:
Format: text Example: <mf:dogs>Will Consider</mf:dogs> Default: (None) - If no value is provided, none will be displayed |
| cats |
|
The policy toward keeping cats in the rental Values:
Format: text Example: <mf:cats>No</mf:cats> Default: (None) - If no value is provided, none will be displayed |
| other_pets |
|
Additional information about pets Format: text Example: <mf:other_pets>Dog beach nearby</mf:other_pets> Default: (None) - If no value is provided, none will be displayed |
| parking |
|
The type of parking available with the rental Values:
Format: text Example: <mf:parking>Gated</mf:parking> Default: (None) - If no value is specified for the parking element, then no parking type will be displayed. |
| parking_spaces |
|
Number of parking spaces available Format: number Example: <mf:parking_spaces>2</mf:parking_spaces> Default: (None) - If no value is specified, then the number of parking spaces will not be displayed |
| laundry |
|
What type of laundry facilities are available Values:
Format: text Example: <mf:laundry>Hookups</mf:laundry> Default: (None) - If no value is provided, none will be displayed |
| open_house_date |
|
The date of the next upcoming open house Format: YYYY-MM-DD ISO 8601 format Example: <mf:open_house_date>2008-12-05</mf:open_house_date> Default: (None) - If no value is provided, no open house information will be displayed |
| open_house_time |
|
Text description of open house schedule Format: text Example: <mf:open_house_time>From Noon to 3:00 PM</mf:open_house_time> Default: (None) - If no value is provided, none will be displayed |


