Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

SimplyRETS Python SDK (Beta)

Deprecation Notice: This SDK is deprecated and will not receive any future updates. The recommended workflow is to use the API directly, or generate an SDK for your use-case from the Swagger Spec

The official Python SDK for the SimplyRETS Listings API.

SimplyRETS provides a modern and simple interface for building robust applications and websites with Real Estate data.


Clone the repo or install simplyrets via pip:

$ git clone


$ pip install simplyrets

Quick Start

Here’s a quick example to set up the client and make a request:

from simplyrets import simplyrets, PropertiesApi

api_client = simplyrets.Connection('simplyrets', 'simplyrets')
properties_api = PropertiesApi.PropertiesApi(api_client)

props =

for prop in props:
    print 'Listing Id: ' + prop.listingId

Setup the client

To start using the SDK, import and create a client by passing your API key and API secret (we have demo credentials available you can use for free!). Here’s a short example:

import simplyrets
api_client = simplyrets.Connection('simplyrets', 'simplyrets')

Examples: Making Requests

Once you have the API Client instantiated you can import the Properties API module and you can then make requests for multiple or single listings.

Request all listings with no filters:

from simplyrets import PropertiesApi

# Pass the API Client to the PropertiesAPI
properties_api = PropertiesApi.PropertiesApi(api_client)

# Make the request
props =

for prop in props:
    print 'Listing Id: ' + prop.listingId

Request a single listing by id:

prop =
print prop.address.full

Multiple query parameters can be sent to the API to request more refined results:

props =
          brokers=["SR1234", "ACME12"]

for prop in props:
  print prop.address.full

Sending back points to get listings in a geographical area:

props =
          points=[ "29.723837146389066,-95.69778442382812"
                 , "29.938275329718987,-95.69778442382812"
                 , "29.938275329718987,-95.32974243164061"
                 , "29.723837146389066,-95.32974243164061"

for prop in props:
    print prop.address.full

Additional Info

View the complete interactive API on the docs page. Here you can find all the available query parameters and the complete response body. You can even see the URL made for that request.


For support regarding the API or bugs in the SDK, can contact us at support (at) simplyrets (dot) com - or leave an issue on the Github page!


SimplyRETS Python SDK




No packages published


You can’t perform that action at this time.