311 Issue Radar — Pothole, Graffiti & City Complaint Tracker

Track potholes, graffiti, illegal dumping, broken streetlights, noise complaints, rodent sightings, and every other type of 311 civic issue from 30+ US cities — all in one structured dataset with coordinates, photos, and status tracking.

What does this actor do?

311 Issue Radar pulls civic complaint data from two sources:

1. Open311 GeoReport v2 — The open standard API used by city governments (Chicago, Bloomington, Peoria).
2. SeeClickFix — The largest civic issue platform in the US, powering 311 systems for hundreds of cities. We use their richer native API for better data: vote counts, comment counts, acknowledgment tracking, and direct web links.

You provide a city (or any lat/lng coordinate), optional keyword filters, and a date range. The actor returns clean, structured JSON with every matching issue.

Who is this for?

Property managers & landlords — Get alerts about issues near your buildings. Know about potholes, dumping, and code violations before your tenants complain. Use the radius filter to search within a specific distance of your properties.

Journalists & researchers — Analyze civic complaint trends across neighborhoods. Which areas have the most reports? What types of issues are increasing? How quickly does the city respond? The enriched data includes vote counts and comment counts showing community engagement.

City contractors & vendors — See where problems are spiking so you can position bids, allocate crews, or pitch services to the right neighborhoods.

Neighborhood organizations & HOAs — Track what's happening on your streets. Use the RSS feed to set up automated alerts in Slack, email, or any feed reader.

Real estate investors — Evaluate neighborhood quality by looking at complaint density, issue types, and resolution rates before buying.

Insurance companies — Assess property risk by analyzing nearby civic complaints (structural issues, flooding, code violations).

Supported cities (30+)

Direct Open311 endpoints (public-domain government data): Chicago IL, Bloomington IN, Peoria IL

SeeClickFix-powered cities (enriched data with votes, comments, and web links): New York NY, Los Angeles CA, Houston TX, Philadelphia PA, Phoenix AZ, San Antonio TX, San Diego CA, Dallas TX, Tucson AZ, Denver CO, Atlanta GA, Miami FL, Seattle WA, Minneapolis MN, Detroit MI, Nashville TN, Charlotte NC, Portland OR, Austin TX, San Francisco CA, Boston MA, Washington DC, Baltimore MD, Columbus OH, Indianapolis IN, Jacksonville FL, New Haven CT

Custom locations: Pass any lat,lng pair to search SeeClickFix's global database, or provide a custom Open311 base URL for unlisted cities.

Input example

{
  "location": "chicago-il",
  "keywords": "pothole,graffiti,dumping",
  "daysBack": 14,
  "status": "open",
  "radiusMiles": 0,
  "maxResults": 500,
  "generateRss": false
}

Radius search example

Search for issues within 2 miles of a specific property:

{
  "location": "40.7128,-74.006",
  "keywords": "noise,dumping,graffiti",
  "daysBack": 30,
  "radiusMiles": 2,
  "maxResults": 100
}

Output example

{
  "service_request_id": "20998178",
  "status": "open",
  "service_code": "122",
  "service_name": "Graffiti",
  "description": "Offensive graffiti on the marble bench near the flag pole",
  "address": "120-148 Church St New Haven, CT, 06510, USA",
  "zipcode": "06510",
  "lat": 41.307226,
  "long": -72.925587,
  "requested_datetime": "2026-02-11T15:32:40-05:00",
  "updated_datetime": "2026-02-11T15:42:04-05:00",
  "expected_datetime": null,
  "agency_responsible": "City of New Haven",
  "media_url": "https://seeclickfix.com/.../photo.jpg",
  "status_notes": null,
  "vote_count": 3,
  "comment_count": 1,
  "acknowledged_at": "2026-02-12T08:00:00-05:00",
  "closed_at": null,
  "html_url": "https://seeclickfix.com/issues/20998178",
  "shortened_url": "http://scf.cm/i/20998178",
  "matched_keywords": ["graffiti"],
  "source": "seeclickfix",
  "source_label": "New Haven, CT"
}

Features

• 30+ city presets — Select a city by name, no configuration needed.
• Any location — Pass a lat/lng pair to search anywhere SeeClickFix operates.
• Keyword filtering — Server-side + client-side matching for fast, precise results.
• Radius search — Search within a specific distance from a point (great for property-focused alerts).
• Enriched data — SeeClickFix cities include vote counts, comment counts, acknowledgment status, and direct web links.
• Deduplication — Automatically removes duplicate issues across paginated responses.
• RSS feed — Generate an RSS 2.0 feed for use with feed readers, Zapier, or Slack integrations.
• Custom endpoints — Works with any Open311 GeoReport v2 server.
• Rate-limit aware — Automatic pacing and retry with exponential backoff on 429/5xx errors.

Running locally

npm install

mkdir -p storage/key_value_stores/default
echo '{"location":"chicago-il","keywords":"pothole","daysBack":7}' > storage/key_value_stores/default/INPUT.json

APIFY_LOCAL_STORAGE_DIR=./storage node src/main.js

Publishing to Apify

npx apify-cli login
npx apify-cli push

Data sources & licensing

• Direct Open311 endpoints — Public domain government data. No restrictions.
• SeeClickFix — Data licensed under Creative Commons BY-NC-SA 3.0. Attribution to SeeClickFix is required.

Changelog

See ./CHANGELOG.md for version history.