Api

To power the webapp, and hopefully to serve for uses down the road, we've built a RESTful API interface to our parcel data. The API is implemented using TastyPie in the file web/api.py.

The following endpoints are provided:

GET parcel/?format=json

Get a list of parcel information dictionaries.

GET parcel/?format=json&pin=XXX

Get the parcel information related to a given PIN. Example: http://54.214.253.39/api/v1/parcel/?format=json&pin=16274210340000 Result:

{
    "meta": {
        "limit": 20,
        "next": null,
        "offset": 0,
        "previous": null,
        "total_count": 1
    },
    "objects": [
        {
            "attic_desc": "Full and Living Area",
            "basement_desc": "Full and Formal Rec. Room",
            "ca_name": "South Lawndale",
            "ca_num": 30,
            "chicago_flag": 0,
            "class_desc": "One Story Residence, Any Age, 1,000 to 1,800 Sq. Ft.",
            "current_building_assmt": 13918,
            "current_land_assmt": 4375,
            "current_total_assmt": 18293,
            "direction": "S",
            "estim_hunit": 1,
            "ext_desc": "Masonry",
            "garage_desc": "2 Cars Detached",
            "gisdate": "gis_1-7-2013",
            "houseno": "2824",
            "id": 983816,
            "lat_y": 41.83980178833,
            "loc": "POINT (1149416.7795026579406112 1884796.7315350766293705)",
            "long_x": -87.72720336914,
            "no_tract_info": false,
            "pin": "16274210340000",
            "place": "Chicago",
            "ptype_desc": "SINGLE FAMILY",
            "resource_uri": "/api/v1/parcel/983816/",
            "sqft_bldg": 1411,
            "sqft_land": 3125,
            "street": "KARLOV",
            "tract_fix": 3018,
            "type_pt_2_4": 0,
            "type_pt_5": 0,
            "type_pt_condo": 0,
            "type_pt_nonres": 0,
            "type_pt_sf": 1,
            "type_pt_unknown": 0,
            "ward": 22,
            "year_built": null
        }
    ]
}

GET auction/

Get a list of foreclosure auctions. Identical PIN specification to the above is available.

GET cashfin/

Get a list of cash-financed transactions. Identical PIN specification to the above is available.

GET foreclosure/

Get a list of foreclosure filings. Identical PIN specification to the above is available.

GET mortgage/

Get a list of mortgages filed with the Recorder of Deeds. Identical PIN specification to the above is available.

GET scavenger/

Get a list of scavenger sale properties. Identical PIN specification to the above is available.

GET transaction/

Get a list of real estate deed transfers. Identical PIN specification to the above is available.

Example: http://54.214.253.39/api/v1/transaction/66151/?format=json

Result:

{
    "addr_final": null,
    "amount": null,
    "city_final": null,
    "date_doc": "2012-04-25T00:00:00",
    "date_rec": "2012-05-07T00:00:00",
    "doc": "1212817044",
    "doc_type": "MORTGAGE",
    "geom": null,
    "id": 66151,
    "lat_y": null,
    "long_x": null,
    "pin": "17092340431286",
    "resource_uri": "/api/v1/transaction/66151/"
}

We also provide aggregated data at the following levels of geography:

• Geography

  • Census Place
  • Census Tract
  • Community Area
  • Cook County Board of Commissioners District
  • Cook County Board of Review District
  • Cook County Park Tax District
  • Cook Judicial Subcircuit
  • County Subdivision
  • Neighborhood
  • Planning District
  • Planning Region
  • Police Beat
  • Police District
  • State House of Representatives District
  • State Senate District
  • Unified School District
  • U.S. Congressional District
  • Ward
  • Zip Code
  • Arbitrary GeoJSON boundary

• Time

  • Month
  • Quarter
  • Year
  • Arbitrary number of days