Contractor Activity Signals avatar

Contractor Activity Signals

Pricing

from $20.00 / 1,000 contractor activity signals

Go to Apify Store
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

Studio EngineerTsai

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

6 days ago

Last modified

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

SignalMeaning
FIRST_SEEN_CONTRACTORThis contractor didn't appear in the baseline window
NEW_PROJECT_FOR_CONTRACTORA contractor already active in the baseline has a new permit
ACTIVITY_CHANGEThis contractor has more than one permit in the current window
WATCHLIST_CONTRACTOR_ACTIVITYThe 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

FieldRequiredDescription
socrataHost / resourceIdno (defaults to San Diego County)Any Socrata county/city portal
currentWindowDaysno (default 14)What counts as "current" activity
baselineWindowDaysno (default 90)Comparison window immediately before "current"
watchlistnoContractor 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.