Knowledge base | Datafiniti

Property Data Schema

The following table outlines available attributes for our property data.

Examples show the JSON format of the data.  CSV format is also available.

Schema NameExampleSearchableNameDescription
address "address": "26 N Main St" Yes Address Street address of an individual property location.
availabilities
"availabilities": [
 {
  "available": [
    "2013-01-01T00:00:00Z - 2013-02-01T00:00:00Z",
    "2013-03-01T00:00:00Z - 2013-04-01T00:00:00Z"
  ],
  "dateSeen": [
    "2013-06-01T00:00:00Z",
    "2013-07-01T00:00:00Z"
  ]
  "unavailable": [
    "2013-03-01T00:00:00Z - 2013-04-01T00:00:00Z"
  ]
 }
]
No Available Dates The availability of a vacation rental property.
Available
A list of dates for which this property is available (e.g., for rent).
Date Seen
The last date this information was seen.
Unavailable
A list of dates for which this property is unavailable (e.g., for rent).
brokers
"brokers": [
 {
  "agent": "Jim Rome",
  "dateSeen": [
    "2013-06-01T00:00:00Z",
    "2013-07-01T00:00:00Z"
  ],
  "company": "Jim Rome Realty",
  "email": "jim@jimrolerealty.com",
  "guid": "5dd27614f9830d957d9546f59447185fdcf61bac5b61e0746ffe086ed3dadd81",
  "phone": "7135673334"
 },
 {
  "agent": "Nancy Drew",
  "dateSeen": [
    "2013-06-01T00:00:00Z",
    "2013-07-01T00:00:00Z"
  ],
  "company": "Investigative Realtors",
  "guid": "abcde7614f9830d957d9546f59447185fdcf61bac5b61e0746ffe086ed3dadd81",
  "phone": "5125673334"
 }
]
No Brokers Information on the broker(s) representing this property
GUID
A unique ID for this child object.
Agent
The broker's or agent's name.
Company
The broker's company.
Phone
The broker's phone number.
Email
The broker's email.
Date Seen
The last date this information was seen.
city "city": "Cedar City" Yes City City of a property.
country "country": "US", Yes Country Country of a property.
dateAdded "dateAdded": "2013-01-15T10:01:23Z" Yes Date Added The date this record was added or created.
dateUpdated "dateUpdated": "2013-02-17T01:22:34Z" Yes Date Updated The date this record was most recently updated.
deposit "deposit": "USD 100" No Deposit  
descriptions
"descriptions": [
 {
  "guid": "5dd27614f9830d957d9546f59447185fdcf61bac5b61e0746ffe086ed3dadd81",
  "description": "A charming 2-bedroom house in a wonderful neighborhood",
  "sourceURL": "http://www.rentals.com/property/12345"
 }
]
No Descriptions A list of descriptions for this property.
GUID
A unique ID for this child object.
Description
The description.
Source URL
The source URL of the description.
encoding "encoding": "UTF-8" Yes Encoding The character encoding for this record.
features
"features": [
 {
  "guid": "7bde8c8617864bd26c67c9653b0dc1b3e361c690b665e88653db531c99a0ed01",
  "key": "WiFi",
  "value": "Available"
 },
 {
  "guid": "522f817823ad69a92f0cca8e7d9939e6cd7ad8b81829d35793dd1577e00b6ab4",
  "key": "Property Manager Available",
  "value": [
   {
    "day": "Monday - Friday",
    "guid": "716cb9436c102e2996699c8daedb378d5911967f5b688b7fb5e47dff32cdaec4"
   }
  ]
 }
]
No Features A list of miscellaneous attributes of the property.
GUID
A unique ID for this child object.
Key
A descriptor for the attribute.
Value
The value of the attribute. Some values may contain an array of information.
fees
"fees": [
 {
  "amount": "USD 100",
  "type": "Cleaning"
 }
]
Yes Fees Specific fees for this property.
Amount
Amount of the fee.
Type
Type of fee.
garageSize "garageSize": "2 cars" Yes Garage Size A description for how large the garage is for this property.
hours
"hours": [
 { 
  "day": "Monday - Friday",
  "hour": "8 am - 5 pm"
 },
 { 
  "day": "Saturday, Sunday",
  "hour": "Closed"
 }
]
No Hours Hour of operation for the property
Day
The day(s) of the week.
Hour
The time of the day.
ids
"ids": [
 {
  "source": "http://www.realestate.com",
  "value": "12345678"
 }
]
No IDs A list of site-specific IDs for this property
Source
The domain where this ID was seen.
Value
The ID.
images
"images": [
 "http://d306gt4zvs7g2s.cloudfront.net/img/w120h160_v1.jpg",
 "http://ab2498ksd32dkd.cloudfront.net/img/w120h160_v2.jpg"
]
No Images A list of image URLs relevant to this property.
isAvailable "isAvailable": false Yes Is Available Whether or not a leased property is available.
key "key": "us/mi/annarbor/2300traverwooddr/2143842849" Yes Key A unique identifier for this record.
languages
"languages": [
 "English",
 "Spanish"
]
No Languages A list of languages spoken at this property.
lat "lat": "29.423548" Yes Lat The latitude coordinate for this property.
leasingTerm "leasingTerm": "Payment is on the first of each month." Yes Leasing Terms Leasing terms of the property, if for rent.
listingType "listingType": "Rental" Yes Listing Type

Type of listing.

Rental
Longer-term rental properties.
Short Term Rental
Short-term/vacation rental properties.
For Sale
Property that is recently for sale.
Rent To Own
Property that can be purchased with a rent-to-own agreement.
Not For Sale
Property is not currently for sale.
long "long": "-98.48461" Yes Long The longitute coordinate for this property.
lotSize "lotSize": "3800 sq. ft." Yes Lot Size Total lot size for the property.
managedBy "managedBy": "AMLI Properties" Yes Managed By The property management company or person.
mlsNumber "mlsNumber": "1234567" Yes MLS # The MLS number.
name "name": "The Winchester" Yes Name The name of the property.
nearbySchools
"nearbySchools": [
 {
  "assigned": "TRUE",
  "distance": "4 miles",
  "gradeLevels": [
    "06",
    "07",
    "08",
    "SE"
  ],
  "name": "St. Mary's"
 }
]
No Nearby Schools The closest schools to the property
Assigned
A true or false value for whether or not the property is assigned to this school.
Distance
The distance to the school.
Grade Levels
The different grades available at this school.
Name
The school's name.
neighborhood "neighborhood": "Live Oak Farms" Yes Neighborhood The neighborhood to which the property belongs.
numBathroom "numBathroom": "3" Yes # of Bathrooms The number of bathrooms.
numBedroom "numBedroom": "2" Yes # of Bedrooms The number of bedrooms.
numBed "numBed": "5" Yes # of Beds The number of beds in this property.
numFloor "numFloor": "2" Yes # of Floors The number of floors in this property.
numPeople "numPeople": "5" Yes # of People The number of people that can occupy this property.
numRoom "numRoom": "8" Yes # of Rooms The number of rooms in this property.
numUnit "numUnit": "89" Yes # of Units The number of units available in this property.
parking "parking": "2-car garage" Yes Parking Special parking stipulations/notes.
paymentTypes
"paymentTypes": [
 "AMEX",
 "Visa",
 "Cash"
]
No Payment Types A list of payment types accepted by this property.
people
"people": [
 {
  "guid": "de6844fc396ac5f1cdeb20283cc9dbaf205eb6106927d49b1cf2611597a07ba9",
  "company": "Arizona Realty",
  "dateSeen": [
    "2015-04-10T08:06:49.253Z",
    "2015-05-10T08:06:49.253Z"
  ]
  "email": "angela@arizonarealty.com",
  "name": "Biz Stone",
  "phone": "555-555-555",
  "title": "Realtor"
 }
]
Existence only People A list of people associated with this property.
GUID
A unique ID for this child object.
Company
The company for this person.
Date Seen
The date this person was seen.
Email
The email of this person.
Name
The name of the person.
Name
The phone # of the person.
Title
The title of the person.
petPolicy "petPolicy": "No dogs allowed", Yes Pet Policy The property's pet policy.
phones
"phones": [
"4355862525",
"7135673334"
]
Yes Phones A list of phone numbers associated with this property.
postalCode "postalCode": "30134" Yes Postal Code The postal or zip code for this property.
possession "possession": "6 months", Yes Possession The possession information for properties in countries in the Indian sub-continent and Asia.
propertyType "propertyType": "Single home" Yes Property Type The property type.
prices
"prices": [
 {
  "guid": "abcde4fc396ac5f1cdeb20283cc9dbaf205eb6106927d49b1cf2611597a07ba9",
  "dateSeen": [
    "2015-01-05T19:15:50.091Z",
    "2015-02-05T19:15:50.091Z"
  ],
  "price": "USD 350000",
  "pricePerSquareFoot": "USD 41.67", 
  "source": "homesforsale.com",
  "sourceURL": "homesforsale/propertyID-12345"
 },
 {
  "guid": "abcde4fc396ac5f1cdeb20283cc9dbaf205eb6106927d49b1cf2611597a07ba9",
  "dateSeen": [
    "2015-01-05T19:15:50.091Z",
    "2015-02-05T19:15:50.091Z"
  ],
  "priceSold": "USD 350000",
  "pricePerSquareFoot": "USD 41.67", 
  "source": "homesforsale.com",
  "sourceURL": "homesforsale.com/propertyID-12345"
 },
 {
  "guid": "abcde4fc396ac5f1cdeb20283cc9dbaf205eb6106927d49b1cf2611597a07ba9",
  "dateSeen": [
    "2015-01-05T19:15:50.091Z",
    "2015-02-05T19:15:50.091Z"
  ],
  "dateValidEnd": "2015-03-01T00:00:00Z",
  "dateValidStart": "2015-01-01T00:00:00Z",
  "minStay": "1 day",
  "offer": "None available",
  "period": "per night",
  "price": "USD 400",
  "source": "rentals.com",
  "sourceURL": "rentals.com/propertyID-12345"
 },
 {
  "guid": "123454fc396ac5f1cdeb20283cc9dbaf205eb6106927d49b1cf2611597a07ba9",
  "dateSeen": [
    "2015-01-05T19:15:50.091Z",
    "2015-02-05T19:15:50.091Z"
  ],
  "dateValidEnd": "2015-02-01T00:00:00Z",
  "dateValidStart": "2015-01-01T00:00:00Z",
  "minStay": "1 day",
  "offer": "None available",
  "period": "per night",
  "salePrice": "USD 350",
  "source": "rentals.com",
  "sourceURL": "rentals.com/propertyID-12345"
 }
]
Existence only Prices A list of prices at which this property has been offered. Regular prices and sale prices will be listed in separate price objects.
GUID
A unique ID for this child object.
Date Seen
The date this price was seen.
Date Valid End
The ending date for which this price is valid.
Date Valid Start
The starting date for which this price is valid.
Minimum Stay
Minimum # of days person must stay.
Offer
A description for any sales offers related to this price.
Period
The time period for which this price is applicable. E.g., "per night", "per week", "per month", etc.
Price
Regular price or for sale price.
Price Per Square Foot
The price divided by square footage of property.
Price Sold
The price at which this property was sold.
Sale Price
Sale price.
Source
The domain where this price was seen.
Source URL
The URL where this price was seen.
propertyTax "propertyTax": "USD 1000" Yes Property Tax The tax associated with this property.
province "province": "NY" Yes Province The state or province for this property.
reviews
"reviews": [
 {
  "guid": "17860f631a3eaf802d868dd70ebe17ee64db79d954105ef53d81aa2d9923867a",
  "date": "2010-07-10T12:00:00Z",
  "numHelpful": 3,
  "rating": "4.0",
  "text": "Very nice place to stay!",
  "title": "Nice place!",
  "sourceURL": "http://www.reviews.com/BobsHouse",
  "userCity": "Atlanta",
  "username": "John123",
  "userProvince": "GA"
 }
]
Existence only Reviews A list of reviews found for this property.
GUID
A unique ID for this child object
Date
The date the review was posted.
# Helpful
The number of people that found this review helpful.
Rating
The rating corresponding to this review.
Source
The domain where this review was found.
Source URL
The URL where this review was found.
Text
The review text.
Title
The title for the review.
User City
The city of the reviewer.
Username
The name of the reviewer.
User Province
The state or province of the reviewer.
rules
"rules": [
 "No loud noises after 10 pm",
 "Trash must be put down the trash chute before 8 pm"
]
No Rules A list of rules applicable to this property.
schoolDistrict "schoolDistrict": "HISD" Yes School District The school district zoned for this property.
size "size": "800 sq. ft." Yes Size Size of property.
sourceURLs
"sourceURLs": [
 "http://www.rentals.com/listing/123",
 "http://www.lettings.com/a/oij3313"
]
Yes Source URLs A list of source URLs that contributed to this record.
type "type": "property" Yes Type The type of record (will always be "property" for property records).
taxId "taxId": "323140909" Yes Tax ID The tax ID for the property
unitName "unitName": "1 BR for Rent" Yes Unit Name Name of the individual unit, such as the type of room at a hotel.