Chicago Requests

Bulk downloader for 311 Requests from the Chicago Open311 API.

To install:

> pip install chicagorequests

To use

Today's Requests

To download today's requests, run:

> chicagorequests

The program will output the requests as line-delimited json. To turn this into a standard json file, you can use a program like jq.

> chicagorequests | jq -s '.'

Date Range Request

To download all requests within a time span:

> chicagorequests --start-date=2021-01-01 --end-date=2021-01-14

Limit to specific request types

To download grafitti removal requests made today:

> chicagorequests -t graffiti_removal 

You can specify more than one type of request

> chicagorequests -t graffiti_removal -t pothole 

To get help

> chicagorequests --help
Usage: chicagorequests [OPTIONS]

  Download service requests from the Chicago Open311 API. By default, today's
  requests of all types. Will write service requests as line-delimited JSON to
  stdout.

Options:
  -s, --start-date [%Y-%m-%d]  the first day of the time range to check
  -e, --end-date [%Y-%m-%d]    the last day of the time range to check
  -t, --request-type TEXT      service types to fetch
  -v, --verbose                verbosity level
  --list-request-types         list valid request types
  --help                       Show this message and exit.

To see all request types:

> chicagorequests --list-request-types
type                             definition
-------------------------------  ----------------------------------------
abandoned_vehicle                Abandoned Vehicle Complaint
affordable_rental_housing_list   Affordable Rental Housing List
air_conditioning_violation       Air Cond./Refrigeration Violation
air_pollution                    Air Pollution, Odor or Dust Complaint
alley_grading                    Alley Grading-Unimproved
alley_light_out                  Alley Light Out Complaint
alley_pothole                    Alley Pothole Complaint
alley_sewer                      Alley Sewer Inspection Request
animal_abandoned                 Animal Abandoned
animal_business                  Animal Business Complaint
animal_fighiting                 Animal Fighting Suspicion
animal_trap                      Animal In Trap Complaint
asbestos                         Asbestos Complaint
bees_wasps                       Bee/Wasp Removal
bicycle_request                  Bicycle Request/Complaint
bike_lane_post                   Bike Lane Post Repair
black_garbage_cart_removal       Black Garbage Cart Removal
blue_recycling_cart              Blue Recycling Cart
board_of_education               Board of Education
bridges                          Bridges and Viaducts (All Types)
public_facility                  Building Public Facility Violation
boiler                           Buildings - Boiler Violation
electrical                       Buildings - Electrical Violation
elevator                         Buildings - Elevator Violation
furnace                          Buildings - Furnace Violation
plumbing                         Buildings - Plumbing Violation
bulk_pickup                      Bulk Pickup
vintage_home                     Bungalow/Vintage Home Information
                                 Request
business_complaint               Business Complaints
cdot_constrcution                CDOT Construction Complaints
cdot_electrical                  CDOT Electrical Operations Construction
                                 Complaints
cha                              CHA Miscellaneous
taxi                             Cab Feedback
cable_cut                        Cable Cut
cable_tv                         Cable TV Complaint
check_for_leak                   Check for Leak
city_clerk_feedback              City Clerk Feedback Request
city_electrical_vault            City Electrical Vault
city_vehicle_sticker_violation   City Vehicle Sticker Violation
vacant_lot                       Clean Vacant Lot Request
green_program                    Clean and Green Program Request
fire_safety                      Commercial Fire Safety Inspection
                                 Request
city_vehicle_condition           Condition of City Vehicle
construction_complaint           Construction & Demolition Complaint
consumer_fraud                   Consumer Fraud Complaint
consumer_business                Consumer Retail Business Complaint
coyote                           Coyote Interaction Complaint
crisis_referral                  Crisis Referral
daycare_center                   Daycare Center
dead_animal_pickup               Dead Animal Pick-Up Request
dead_bird                        Dead Bird
disabled_parking                 Disabled Parking
divvy_bike_parking               Divvy Bike Parking Complaint
escooter_parking                 E-Scooter Parking Complaint
electrical_sign_inspection       Electrical Sign Inspection
equipment_noise                  Equipment Noise Complaint
fire_assistance                  Fire Assistance
fire_miscellaneous               Fire Miscellaneous
flooded_viaduct                  Flooded Viaduct
fly_dump_tires                   Fly Dump (Tires)
fly_dumping                      Fly Dumping Complaint
furniture_repair_cta             Furniture Repair - CTA
garbage_cart_maintenance         Garbage Cart Maintenance
gas_station                      Gas Station and Storage Tank Complaint
graffiti_removal                 Graffiti Removal Request
groceries                        Groceries
guardrail_maintenance            Guardrail and Roadside Protection
                                 Maintenance
gym_shoe_electrical_wire         Gym Shoe/Object On Electrical Wire
health_club                      Health Club
home_buyer_program_info          Home Buyer Program Info Request
homeless_prevention              Homeless Prevention
hotel_motel_health_dept          Hotel/Motel - Health Department
housing_inquiries                Housing Inquiries
how_is_my_driving                How's my driving?
hydrant_cap_missing              Hydrant Cap Missing
hydrant_check                    Hydrant Check
ice_snow_removal                 Ice and Snow Removal Request
illegal_dumping                  Illegal Dumping
in_ground_pedestrian_crossing    In-Ground Pedestrian Crossing Sign
                                 Repair
inaccurate_fuel_pump             Inaccurate Fuel Pump Complaint
inaccurate_retail_scales         Inaccurate Retail Scales Complaint
inspect_public_way               Inspect Public Way Request
landscape_median_maintenance     Landscape Median Maintenance
lead_inspection                  Lead Inspection Request
licensed_pharmaceutical_rep      Licensed Pharmaceutical Representative
                                 Complaint
liquor_establishment             Liquor Establishment Complaint
locate_service_bbox              Locate/ID Main/Service/BBox/Meter Vault
low_water_pressure               Low Water Pressure Complaint
midway_customer_service          Midway Customer Service
midway_facilities                Midway Facilities Complaint
missed_garbage_pickup            Missed Garbage Pick-Up Complaint
missing_lid_grate_cover          Missing Lid/Grate/Cover
mobile_food_vehicle              Mobile Food Vehicle
mosquito_spraying_inquiries      Mosquito Spraying Inquiries (Formerly
                                 West Nile Virus)
construction_rodent_inspection   New Excavation or Construction Rodent
                                 Siting Inspection
no_air_conditioning              No Air Conditioning
no_building_permit               No Building Permit and Construction
                                 Violation
no_solicitation                  No Solicitation Complaint
no_vehicle_idling                No Vehicle Idling (Diesel)
no_water                         No Water Complaint
nuisance_animal                  Nuisance Animal Complaint
ohare_customer_service           O'Hare Customer Service
ohare_facilities                 O'Hare Facilities Complaint
open_fire_hydrant                Open Fire Hydrant Complaint
outdated_merchandise             Outdated Merchandise Complaint
paid_sick_leave                  Paid Sick Leave Violation
park_repair_maintenance          Park Repair/Maintenance
park_rodent_abatement            Park Rodent Abatement
pavement_buckle_repair           Pavement Buckle Repair
pet_wellness_check               Pet Wellness Check Request
police_misc                      Police Miscellaneous
porch_inspection                 Porch Inspection Request
pothole                          Pothole in Street Complaint
bike_lane_debris_removal         Protected Bike Lane - Debris Removal
public_vehicle                   Public Vehicle/Valet Complaint
pushcart_food_vendor             Pushcart Food Vendor Complaint
recycling_inspection             Recycling Inspection Request
recycling_pickup                 Recycling Pick Up
red_light_camera                 Red Light Camera
relocated_vehicle                Relocated Vehicle
relocation                       Relocation Request
renters_foreclosure              Renters and Foreclosure Complaint
injured_animal_report            Report an Injured Animal
water_shut_off_occupied          Request Water Shut-Off Occupied Building
water_shut_off_vacant            Request Water Shut-off Vacant Building
fire_hydrant_custodian           Request to Install Custodian on Fire
                                 Hydrant
restaurant                       Restaurant Complaint
ridesharing                      Ridesharing Complaint
rats                             Rodent Baiting/Rat Complaint
sanitation_code_violation        Sanitation Code Violation
sanitation_tire_pickup           Sanitation Tire Pickup
sewer_cave_in_inspection         Sewer Cave-In Inspection Request
sewer_cleaning_inspection        Sewer Cleaning Inspection Request
sewer_outfall_investigation      Sewer Outfall Investigation
shared_cost_sidewalk             Shared Cost Sidewalk Program Request
vacation_rental                  Shared Housing/Vacation Rental Complaint
shelter                          Shelter Request
sidewalk_cafe                    Sidewalk Cafe Complaint
sidewalk_inspection              Sidewalk Inspection Request
sign_loading_standing_zone       Sign - Loading or Standing Zone (New
                                 Installation, Amendment, Removal)
sign_repair_base_bolt_removal    Sign Repair -  Base / Bolt Removal
sign_repair_all_other_signs      Sign Repair Request - All Other Signs
sign_repair_do_not_enter         Sign Repair Request - Do Not Enter Sign
sign_repair_one_way              Sign Repair Request - One Way Sign
sign_repair_residential_parking  Sign Repair Request - Residential Permit
                                 Parking
sign_repair_stop                 Sign Repair Request - Stop Sign
ramps_and_repairs_for_seniors    Small Accessible Repairs and Ramps for
                                 Seniors
smokeless_tobacco                Smokeless Tobacco at Sports Event
                                 Complaint
smoking_food_establishment       Smoking: Food Establishment
smoking_non_food_establishment   Smoking: Non-Food Establishment
snow_object_dibs_removal         Snow - Object/Dibs Removal Request
snow_protected_bike_lane         Snow Removal - Protected Bike Lane or
                                 Bridge Sidewalk
snow_uncleared_sidewalk          Snow – Uncleared Sidewalk Complaint
speed_camera                     Speed Camera
speed_hump_repair                Speed Hump Repair
spills_or_dumping                Spills or Dumping in Natural Water Ways
stray_animal                     Stray Animal Complaint
street_cleaning                  Street Cleaning Request
street_light_on_during_day       Street Light On During Day Complaint
street_light_out                 Street Light Out Complaint
street_light_pole_damage         Street Light Pole Damage Complaint
street_light_pole_door_missing   Street Light Pole Door Missing Complaint
street_paint_marking             Street Paint Marking Maintenance
swimming_pool_insp               Swimming Pool Insp
tanning_and_body_art             Tanning and Body Art Complaint
tobacco_general                  Tobacco - General Complaint
tobacco_sale_to_minors           Tobacco - Sale to Minors Complaint
toxic_hazardous_materials        Toxic and Hazardous Materials
traffic_calming_devices          Traffic Calming Devices – Existing
traffic_signal_out               Traffic Signal Out Complaint
traffic_signal_timing            Traffic Signal Timing
trap_pickup                      Trap Pick-Up
tree_debris_cleanup              Tree Debris Clean-Up Request
tree_emergency                   Tree Emergency
tree_planting                    Tree Planting Request
tree_removal                     Tree Removal Request
tree_trim                        Tree Trim Request
unwanted_animal                  Unwanted Animal
vacant_abandoned_building        Vacant/Abandoned Building Complaint
ventilation_violation            Ventilation Violation
viaduct_light_out                Viaduct Light Out Complaint
vicious_animal                   Vicious Animal Complaint
volunteer_network                Volunteer Network
wage_complaint                   Wage Complaint
water_on_street                  Water On Street Complaint
water_in_basement                Water in Basement Complaint
weed_removal                     Weed Removal Request
wildlife_in_home                 Wildlife Assistance in Living Quarters
wire_basket                      Wire Basket Request
wire_down                        Wire Down
yard_waste                       Yard Waste Pick-Up Request