Documentation

Overview

The Trulia API enables outside applications to make calls to acquire Trulia data. All calls are available to any developer through a standard Rest-based format.

Libraries

• LocationInfo: Allows you to get the following geographical location information, including longitude and latitude, for use in other calls:

  • Neighborhoods in a City
  • Cities in a State
  • Counties in a State
  • List of all 50 States
  • Zip codes in a State

• TruliaStats: Allows you to access the following statistics pertaining to Trulia traffic and for sale listing data on Trulia:

  • Avg. and median listing price of homes on Trulia
  • Avg. and median listing price of homes on Trulia by number of bedrooms
  • Number of listed homes on Trulia
  • Number of listed homes on Trulia by number of bedrooms
  • Percent of total Trulia traffic to locations of interest

To find the valid function calls and parameters for each library, use the links on the right to bring up library documentation.

Request Format

• Call request format: All API calls will have as their first two parameters library and function. For example, to call the function getAllCitiesInState from library LocationInfo you will begin your call with:

http://api.trulia.com/webservices.php?library=LocationInfo&function=getCitiesInState
&state=CA&apikey=abc123

• Authentication: All API calls need to include the authentication parameter "&apikey=" + key.
• Date format: Dates are expected to be in the format YYYY-MM-DD.
• Date ranges: Date ranges are limited to those for which Trulia has data. For traffic stats, the earliest possible date with meaningful information is 2006-06-01, and the latest is current within a week. For listing stats the earliest possible date has a weekEndingDate of 2006-11-10 and is current within a week. However, the earliest possible date for median listings price stats has a weekEndingDate of 2007-01-05.

Request Limit

If you think you need more, please request a higher call limit by emailing developers@trulia.com.

• Limit calls to 5,000 per day, per API key
• Limit queries to 2 per second, per API key