Movefrog - Apartments and Home Rentals
Movefrog - Apartments and Home Rentals
Renters and Landlords Login
Email:
Pass:
New Feature! Instant Notification via Email or Text Message - FREE FOR A LIMITED TIME!   

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:
  1. 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.

  2. 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.

Once your feed has been created and published, go to your Account Settings page (login required) to tell us where we can read your file.

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>
<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>
<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>
</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:".

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:
  • for rent - Indicates a standard rental
  • room for rent - Indicates a roommate rental

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:
  • apartment
  • house
  • commercial
  • condo
  • coop
  • farm
  • land
  • manufactured
  • multifamily
  • ranch
  • single family
  • townhouse
  • guesthouse
  • hotel
  • office
  • garage
  • storage
  • boatslip
  • highrise
  • midrise

Format: text

Example: <mf:property_type>house</mf:property_type>

Default: apartment
lister_class
The type of party advertising the property

Values:
  • owner - The owner or manager of the property
  • fee - A fee-based broker
  • nofee - A non-fee broker
  • roommate - A tenant advertising an open room
  • tenant - The current tenant advertising the complete rental

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:
  • All Utilities Paid
  • Association Fees Paid
  • Balcony
  • Cable TV Paid
  • Cable-ready
  • Carpet
  • Central Air
  • Central Heat
  • Controlled Access
  • Den
  • Dishwasher
  • Disposal
  • DSL-ready
  • Electric Fireplace
  • Electric Paid
  • Elevator
  • Family Room
  • Formal Dining Room
  • FTTP-ready
  • Furnace
  • Gardener Paid
  • Gas Fireplace
  • Gas Paid
  • Gated Entry
  • Hardwood
  • High Speed Internet Paid
  • Hot Water Paid
  • Jacuzzi
  • Linoleum
  • Maid Service Paid
  • Microwave
  • Noncentral Air
  • Nonsmoking Property
  • Nonsmoking Unit
  • Patio
  • Phone Paid
  • Pool
  • Pool Service Paid
  • Porch
  • Refrigerator
  • Rent Control
  • Satellite Allowed
  • Satellite TV Paid
  • Satellite-ready
  • Section 8 OK
  • Security Building
  • Stove
  • Study
  • Tile
  • Trash Service Paid
  • Vinyl
  • Water Paid
  • Wheelchair Accessible
  • WiFi
  • Wood Fireplace
  • Yard

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:
  • none - No email address will be displayed
  • normal - Your email address, as provided in the agent_email element will be displayed
  • anon - MoveFrog will generate an anonymous email address that will forward to the email you specify in the agent_email element

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:
  • true
  • false

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:
  • true
  • false

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:
  • month
  • week
  • day

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:
  • Furnished
  • Unfurnished
  • Partially Furnished
  • Optionally Furnished
  • Optionally Partially Furnished

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:
  • One year
  • Six month
  • Three month
  • Month-to-month
  • Weekly
  • Daily
  • Flexible
  • Two year

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:
  • OK
  • Will Consider
  • Small
  • Will Consider Small
  • No

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:
  • OK
  • Will Consider
  • No

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:
  • Underground
  • Gated
  • Covered
  • Permit
  • Garage
  • Enclosed
  • Tandem
  • Valet
  • Driveway
  • Reserved
  • Carport
  • Street

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:
  • In Unit
  • Hookups
  • On Premises
  • No

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