Creating your data feed
Your data feed must be in one of the supported formats listed below. For help choosing a format, please see our feed format page.
| Tab-delimited | RSS 1.0 | RSS 2.0 | Atom 0.3 | Atom 1.0 |
| Instructions | Instructions | Instructions | Instructions | Instructions |
| Sample (.txt) Sample (.xls) | Sample | Sample | Sample | Sample |
In addition to following the Google Base Program Policies, your items must also meet these requirement(s):
- Items and landing pages must list prices in US dollars.
When creating your feed, you will need to provide information about your items in the form of attributes. Click on any attribute below to view the attribute's definition.
- description
- link
- listing_type
- foreclosure: Purchase of a foreclosed property.
- for rent: Rental of a whole housing unit offered by landlord by the month or year.
- for sale: Purchase of an existing property.
- new home: Purchase of a build-to-order home that has not been built yet.
- room for rent: Shared rental of a housing unit.
- sublet: Rental of a whole housing unit offered by tenant for a period shorter than the lease.
- location
- price
- title
| Text describing the item. Do not include promotional or boilerplate text, such as "Free shipping!" or "Click here now!" We search over this text when matching user queries to your item. Please make sure you include the same item description available on your website in the description field in your data feed. |
| Format: Text, up to a maximum length of 10,000 characters. |
| Tab-delimited example: Sunlit room in a ranch style, single-story house. |
| XML example: <description>Sunlit room in a ranch style, single-story house.</description> |
| The URL of the web page associated with the item. This should not forward to another URL; it must point directly to the target page. The domain name may not be an IP address. |
| Format: URL. (Must include the http:// portion.) |
| Tab-delimited example: http://www.example.com/asp/sp.asp?cat=12&id=1030 |
| XML example: <link>http://www.example.com/asp/sp.asp?cat=12&id=1030</link> |
| The type of transaction for this listing. |
| Format: Text. Appropriate values include: |
| Tab-delimited example: for sale |
| XML example: <g:listing_type>for sale</g:listing_type> |
| The location of the item. |
| Format: Addresses should be formatted as: street, city, state, postal code, country. Each location element should be separated by a comma. Locations are validated through Google Maps. |
| Tab-delimited example: 1600 Amphitheatre Parkway, Mountain View, CA, 94043, USA |
| XML example: <g:location>1600 Amphitheatre Parkway, Mountain View, CA, 94043, USA</g:location> |
| The price for the item. |
| Format: Number. |
| Tab-delimited example: 25.00 |
| XML example: <g:price>25.00</g:price> |
| The name or title of the item. |
| Format: Text. Maximum length of 80 characters. Commas are allowed. |
| Tab-delimited example: Room for rent in Mountain View, CA |
| XML example: <title>Room for rent in Mountain View, CA</title> |
- bathrooms
- bedrooms
- broker
- id
- image_link
- listing_status
- mls_listing_id
- mls_name
- parking
- price_type
- property_type
- provider_class
- video_link
- year
| The number of bathrooms. |
| Format: Number. |
| Tab-delimited example: 2.5 |
| XML example: <g:bathrooms>2.5</g:bathrooms> |
| The number of bedrooms. |
| Format: Number. |
| Tab-delimited example: 4 |
| XML example: <g:bedrooms>4</g:bedrooms> |
| Real estate broker responsible for a property. |
| Format: Text. |
| Tab-delimited example: Acme Real Estate |
| XML example: <g:broker>Acme Real Estate</g:broker> |
| A unique alphanumeric identifier for the item - e.g., your internal ID code. IMPORTANT: Once you submit an item with a unique id, this identifier must not change when you send in a new data feed. Each item must retain the same id in subsequent feeds. |
| Format: Text. |
| Tab-delimited example: 01flx |
| XML example: <g:id>01flx</g:id> |
| The URL of an associated image for the item. Use your full-sized images, not thumbnail images. If you do not have an image available, leave the attribute blank. Do not include logos or an image that says, "Image not available." |
| Format: URL. (Must include the http:// portion.) Up to 10 URLs can be included. For tab-delimited, separate each URL by a comma. For XML, include each URL as a separate <image_link> attribute. |
| Tab-delimited example: http://www.example.com/image1.jpg,http://www.example.com/image2.jpg |
| XML example: <g:image_link>http://www.example.com/image1.jpg</g:image_link> <g:image_link>http://www.example.com/image2.jpg</g:image_link> |
| The status of a property listing. |
| Format: Text. Appropriate values include: active, offer, contract, closed, and withdrawn. |
| Tab-delimited example: active |
| XML example: <g:listing_status>active</g:listing_status> |
| The unique ID assigned to this listing by a Multiple Listing Service. |
| Format: Text. |
| Tab-delimited example: 246812 |
| XML example: <g:mls_listing_id>246812</g:mls_listing_id> |
| The name of the Multiple Listing Service where a property is listed. |
| Format: Text. |
| Tab-delimited example: Acme MLS |
| XML example: <g:mls_name>Acme MLS</g:mls_name> |
| number of parking places. |
| Format: number |
| Tab-delimited example: 1 |
| XML example: <g:parking>1</g:parking> |
| The type of pricing for the item. |
| Format: Acceptable values are: negotiable or starting. |
| Tab-delimited example: negotiable |
| XML example: <g:price_type>negotiable</g:price_type> |
| A description of the physical property and any shared ownership. |
| Format: Text. Appropriate values include: apartment, commercial, condo, coop, farm, land, manufactured, multifamily, ranch, single family, tic, and townhouse. |
| Tab-delimited example: apartment |
| XML example: <g:property_type>apartment</g:property_type> |
| The type of data provider responsible for the bulk upload. |
| Format: Acceptable values are: agent, aggregator, broker, franchisor, homebuilder, mls, other, and publisher. |
| Tab-delimited example: broker |
| XML example: <g:provider_class>broker</g:provider_class> |
| The URL of an associated YouTube video for the item. |
| Format: URL. (Must include the http:// portion.) Up to 10 URLs can be included. For tab-delimited, separate each URL with a comma. For XML, include each URL as a separate video_link attribute. |
| Example: |
| The model year or year built. |
| Format: Year, in four digits: YYYY. |
| Tab-delimited example: 2005 |
| XML example: <g:year>2005</g:year> |
- agent
- area
- expiration_date
- feature
- hoa_dues
- latitude
- longitude
- lot_size
- model
- open_house_date_range
- property_taxes
- school
- school_district
- style
- zoning
| Individual who is negotiating and arranging the real estate sale. |
| Format: Text. |
| Tab-delimited example: Sue Smith |
| XML example: <g:agent>Sue Smith</g:agent> |
| The interior area of a property. |
| Format: Number and unit. |
| Tab-delimited example: 1000 square ft. |
| XML example: <g:area>1000 square ft.</g:area> |
| The date that the item listing expires or that information about this item is going to change. |
| Format: ISO 8601 format: YYYY-MM-DD. Note: all dates and times are in PST (GMT -8). |
| Tab-delimited example: 2006-12-20 |
| XML example: <g:expiration_date>2006-12-20</g:expiration_date> |
| A feature or amenity of a property. |
| Format: Text. |
| Tab-delimited example: Cathedral ceilings |
| XML example: <g:feature>Cathedral ceilings</g:feature> |
| The monthly dues paid to a homeowners association. |
| Format: Number. |
| Tab-delimited example: 400 |
| XML example: <g:hoa_dues>400</g:hoa_dues> |
| The precise latitude of the listing. Provide only if known accurately. If blank, a Google geocoder will be used on the address in the location attribute. |
| Format: Number (decimal permitted). |
| Tab-delimited example: 23.433334 |
| XML example: <latitude>23.433334</latitude> |
| The precise longitude of the listing. Provide only if known accurately. If blank, a Google geocoder will be used on the address in the location attribute. |
| Format: Number (decimal permitted). |
| Tab-delimited example: -91.412324 |
| XML example: <longitude>-91.412324</longitude> |
| Size of a property's lot. |
| Format: Number and unit. |
| Tab-delimited example: 43560 square ft. |
| XML example: <g:lot_size>43560 square ft.</g:lot_size> |
| The name that describes the floorplan of a property. |
| Format: Text. |
| Tab-delimited example: Classic Comfort AS-1234 |
| XML example: <g:model>Classic Comfort AS-1234</g:model> |
| Information about the date and time an open house will take place. |
| Format: ISO 8601 format: YYYY-MM-DDThh:mm:ss. (Times are based on the 24-hour clock.) This can either be a start date or a date range. For tab-delimited, if a range of dates is included, separate the start and end dates by a forward slash. For XML, two sub-attributes are included in this attribute: <start> and <end>. Note: all dates and times are in the local timezone of the property being listed. |
| Tab-delimited example: 2006-12-10T00:00:01/2006-12-16T23:59:59 |
| XML example: <g:open_house_date_range><g:start>2006-12-10T00:00:01</g:start> <g:end>2006-12-16T23:59:59</g:end></g:open_house_date_range> API users should use this syntax: <g:open_house_date_range>2006-12-10T00:00:01 2006-12-16T23:59:59</g:open_house_date_range> |
| The property taxes for the property. |
| Format: Number. |
| Tab-delimited example: 500.00 |
| XML example: <g:property_taxes>500.00</g:property_taxes> |
| A school that services the property. |
| Format: Text. |
| Tab-delimited example: Union High School |
| XML example: <g:school>Union High School</g:school> |
| The school district the property is in. |
| Format: Text. |
| Tab-delimited example: Union School District |
| XML example: <g:school_district>Union School District</g:school_district> |
| The architectural style of a property. |
| Format: Text. Appropriate values include: Cape Cod, Colonial, Craftsman, Gothic, Prairie, Ranch, Split Level, Tudor, and Victorian Queen Anne. |
| Tab-delimited example: Colonial |
| XML example: <g:style>Colonial</g:style> |
| The zoning of the property. |
| Format: Text. Appropriate values include: agricultural, commercial, industrial, recreational, residential, unincorporated. |
| Tab-delimited example: residential |
| XML example: <g:zoning>residential</g:zoning> |
Other Attributes
If you have attributes that do not fit into one of the predefined attributes listed above, you can still send them to us. Check these resources for more information: