API Details

The default data source is “Zillow Group” which includes Zillow, Trulia, Hotpads and StreetEasy metrics. If you would like to look at just Zillow or just Trulia data, you will need to specify the dataSource in your API call. 

Zillow Group does not offer developer services to help with coding or the implementation of our Reporting API. We recommend using our spec as a guide, and researching third-party API development platforms.

Data in the Reporting API is usually 2 days behind (this is expected because of different system processes). It is possible to have more of a lag when there are service delays or major updates, but the expected behavior is no more than 2 days behind.

Zillow Group will configure your access list upon receiving your request. Your access list may include MLS feeds, or broker direct feeds and we recommend periodically calling your access list for up-to-date information. If you need to add or remove office IDs and feeds from your access list, please email us at BrokerOperations@ZillowGroup.com.

·       Consumer Key – use any non-empty value
·       Consumer Secret – use the string ‘none’

The Zillow Group Reporting API is connected to our MLS data system, and was originally made for stats on listings that are sourced directly from the MLS on our site. If your data is not MLS sourced, you may need to use the “minimal” parameter in order to return the correct results. Using “&mimimal” may also improve general performance, however it will not return the full address of the listing (only the MLS ID will be returned). Please email us at BrokerOperations@ZillowGroup.com for more information.

A feed listings summary call will only return the first 1,000 listings. To continue to view listings, use the “from” parameter to request the next group (i.e. “from=0” will return listings 0-1,000; “from=1000” will return listings 1,000-2,000 etc.).

After you have submitted an official request via our form, we will ask you to send a list of MLSs and the associated office IDs you need data for. We prefer an Excel doc/CSV file with the following columns:

– MLS Name
– MLS Office ID
– Office Name

If you are a large Broker or Vendor with numerous MLSs and/or office IDs, we may request you provide us with a list of affiliations that adheres to our standardized format and naming conventions. This helps to expedite the process, so you can get to your data more quickly!

First, we recommend checking to see if you have access to the right feed and/or office ID using your credentials. If you do, then we suggest adjusting the “from” parameter, or adding the “minimal” parameter to your call as this typically pulls in the data. We also suggest checking the individual listing endpoint, as this will allow you to call our API for a specific listing, rather than searching at the office or feed level. Should you need further help or need to make changes to your Access List, please email us at BrokerOperations@ZillowGroup.com.

We highly recommend using the program Postman for API calls, however, at times your calls may return an “unauthorized” error. This is a known Postman-specific issue, and usually if you send the call again, it will work (may have to resend a few times). If you continue to test in Postman and still aren’t able to grab any results after 4 tries, there may be an issue with your account such as missing MLSs or OfficeIds from the Access List. Please email us at BrokerOperations@ZillowGroup.com for help.