dancrew32 / zirrow

Self-documenting Zillow Api in Ruby/Sinatra

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Zirrow

Zirrow is a Zillow Api wrapper written in Ruby, designed to self-document in a Sinatra app.

Demo

zirrow.danmasq.com

Install

To get all the gems, bundle install

If you just want a really simple Zillow Api class, use /api/Zirrow.rb.

If you want to run the api site, just rackup config.ru or if you're on Heroku, heroku create && git push heroku master.

No clue what rack is? Read about here Rack

You'll need to request a Zillow Api Key to get rolling.

When you get your key, go in and edit the settings in app.rb.

What's it do?

Zirrow scrapes the many pages of the Zillow Api Documentation for summaries of each api when you create a new method in Zirrow.rb and implement it in the Sinatra app.

How do I use it?

The following returns search results (json) for this address:

@z = Zirrow.new :key => 'myZWSID'
@z.search 'address' => '184 17th ave', 'citystatezip' => 'san francisco ca'	

What's it going to do?

Zirrow will eventually scrape the api parameters and dynamically compare existing parameters to ensure this api wrapper is up to date. It's even going to dynamically write this README and push it to github.

About

Self-documenting Zillow Api in Ruby/Sinatra


Languages

Language:JavaScript 73.3%Language:Ruby 26.7%