top
(README.md)
# craigslist-parser

This parser is a simple project so my roommates and I could locate all the available housing in the area we were moving.  It scrapes the HTML and returns JSON at the server endpoint which a client can call. The goal was to create something in less than a day that could give us all the details we need at a moments notice.  It was not built with any other considerations.

<img src="imgs/results.png" width="500"/>

## Running locally

1. Get the repo.

  ```shell
go get github.com/JoshRosso/craigslist-parser
  ```

1. Run the application.

  ```shell
cd $GOPATH/src/github.com/joshrosso/craigslist-parser
go run
  ```

1. Make a request

  ```shell
go run *
curl http://localhost:3000/rentals/{craigslist-location}
  ```

  Locations are available [At the Craigslist sites page](https://www.craigslist.org/about/sites)

## Running remotely

I'd recommend using app engine or supervisor to run this application.  Instructions for running a process with [supervisord can be found online](http://supervisord.org/).  If you're interested in a simple example of a frontend calling this service you can checkout [thecoloradomove](https://github.com/JoshRosso/thecoloradomove)

Imports 2 package(s) ΒΆ

  1. github.com/PuerkitoBio/goquery
  2. github.com/go-martini/martini