Contractor Activity Signals
Pricing
from $20.00 / 1,000 contractor activity signals
Contractor Activity Signals
Turns public building-permit activity into decision-ready contractor change signals: first-seen contractors, new projects for known contractors, repeat activity, and optional watchlist matches. Not a raw permit feed -- a signal layer for deciding who needs a review, not another scraper.
Pricing
from $20.00 / 1,000 contractor activity signals
Rating
0.0
(0)
Developer
Studio EngineerTsai
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
6 days ago
Last modified
Categories
Share
A raw permit row isn't a decision. A contractor starting new work is — that's the moment vendor/compliance review actually matters.
This Actor turns public building-permit activity into decision-ready events: a contractor you've never seen before, an existing contractor starting a new project, repeat activity in a short window, or activity matching a watchlist you supply.
It is not another permit scraper — that already exists as a separate, free primitive. This Actor is the signal layer built on top of it.
What you get
One signal per real event:
{"signal_type": "FIRST_SEEN_CONTRACTOR","contractor": "ELEC ELECTRIC","permit_id": "PDS2023-RESALT-015757","current_activity": "Existing Residential Main Electrical Service Upgrade - 200A","first_seen": true,"changed_state": "NEW","source": "https://data.sandiegocounty.gov/resource/dyzh-7eat.json","observed_at": "2026-08-30T10:00:44Z","review_reason": "contractor not seen in the prior baseline window -- first real activity observed","insurance_status": "NOT_OBSERVED"}
Real output, from a real run against San Diego County's public data: 303 permits in the current window, 140 distinct contractors, 473 signals, 71 of them genuinely first-seen.
Signal types
| Signal | Meaning |
|---|---|
FIRST_SEEN_CONTRACTOR | This contractor didn't appear in the baseline window |
NEW_PROJECT_FOR_CONTRACTOR | A contractor already active in the baseline has a new permit |
ACTIVITY_CHANGE | This contractor has more than one permit in the current window |
WATCHLIST_CONTRACTOR_ACTIVITY | The permit matches a name you're watching for |
What this Actor does NOT claim
insurance_status is always "NOT_OBSERVED". This Actor has no
certificate-of-insurance data source. A signal means "this activity may be
worth a compliance review," never "this contractor is compliant" or
"non-compliant." Don't use it as a substitute for actually checking.
Input
| Field | Required | Description |
|---|---|---|
socrataHost / resourceId | no (defaults to San Diego County) | Any Socrata county/city portal |
currentWindowDays | no (default 14) | What counts as "current" activity |
baselineWindowDays | no (default 90) | Comparison window immediately before "current" |
watchlist | no | Contractor name fragments to flag specifically |
Windows are relative to the dataset's own most recent record, not today's date — this works correctly whether your source portal updates daily or is a static archive.