RESO Web API Overview
Built within Spark API is a /Reso/OData endpoint that implements RESO's Web API, and provides data using the RESO Data Dictionary. We currently only support the 1.1 version of the data dictionary at this endpoint.
The documentation we provide does not fully document the RESO Web API itself; rather, it's meant to get you up and running on our implementation of the standard.
- Making Requests
- Response Description
The RESO Web API endpoint is at:
Because the RESO Web endpoint is built on Spark API, you can use the same API keys provided for Spark to access the RESO Web endpoint.
The method for obtaining authorization from end users and making authenticated requests is identical to accessing Spark directly.
See our authentication documentation for more information, as well as our example stepping through the OpenID+OAuth 2 Hybrid Flow.
3. Making Requests
Our RESO Web API provides the following distinct endpoints:
Retrieving Meta Data
Metadata is accessible at:
Using the properties resource as our example, all properties can be retrieved at:
https://sparkapi.com/Reso/OData/Properties...and an individual property can be retrieved at...
https://sparkapi.com/Reso/OData/Properties('<PropertyId>')<PropertyId> is the same data as StandardFields.ListingKey or Id when using the Spark API listing's service. So, if the listing's Id was 20100000000000000000000000, your request would be:
https://sparkapi.com/Reso/OData/Properties('20100000000000000000000000')Note that the Media endpoint is accessed as a subresource of listings. So, to find the media for listing 20100000000000000000000000, your would hit the URI:
Each service supports some or all of the request parameters documented on our RESO request parameters page.
All responses from this endpoint are in ATOM/XML format. Since this may change, we suggest specifically using an Accept header of application/xml