New Homeowner & Business Leads (Certificates of Occupancy)
Pricing
from $6.00 / 1,000 permit records
New homeowner and new business leads: certificates of occupancy from Accela Citizen Access cities, one row per newly finished home or business premises.
Accela agency key. See agencies.json for 24 verified portal URLs.
HTTPS base URL ending with the agency key and a slash. Bundled deployment permits aca-prod.accela.com.
Citizen Access module using General Search: Building, Enforcement or Planning. Known names are trimmed and normalized; other module names retain their casing. Availability varies by agency; unsupported modules fail clearly.
Search the last N calendar days ending today, instead of fixed dateFrom and dateTo. Leave at 0 to use the fixed dates.
Names from the portal's own "Record Type" list on its General Search page, for example "Commercial Temp Certificate of Occupancy". The portal then returns only those record types, which is far faster and cheaper than reading every record in the date range. Leave empty and the actor picks the matching record types itself from "Permit type contains"; it falls back to reading everything when the agency publishes no list. A name the agency does not offer stops the run and lists what it does offer.
[]Case-insensitive substring matching; any listed string may match. The default matches every certificate of occupancy, temporary certificate of occupancy and occupancy permit type. Emptying the list returns every permit.
[ "occupancy"]Zero disables filtering. A positive value excludes unknown valuations; enable includeDetails to read valuation when published.
The most rows one run delivers. When a run stops at this limit, the "only new permits" memory is not updated, so nothing is skipped next time.
Ceiling on search result pages one run reads, across all record types. On reaching it the run stops tidily, delivers everything found so far and says so. Raise it only when a run reports that it stopped here; a wide date range on a busy agency is usually better narrowed instead.
Fetch public detail links for contractor, parcel, dates and valuation. Owner names additionally require includeOwnerName. Each fetched detail page costs $0.004, even if a valuation filter later excludes the record.
Include the property owner's name from the permit detail page. Off by default because owners are usually private individuals.
Deliver only permits applied for after the newest one a previous run delivered. Needs a key-value store selected below as stateStoreId; give each schedule its own. A run that stops early does not move the marker forward.
Key-value store that remembers the newest applied date delivered by sinceLastRun runs. Create one in Apify Console and select it here; each schedule should have its own.
Optional list of permit numbers and statuses from an earlier run, to compare against. Permit numbers match without regard to case.
[]Deliver only permits from the list above whose status is different now. Needs a non-empty list.
A key-value store the actor uses to remember every permit's status between scheduled runs. The first complete run delivers everything and saves the statuses; later runs deliver only permits whose status changed. Use one store per schedule and let runs finish one at a time.
Safety limit on search result pages when watching status changes. If the limit is reached, the run stops and the saved statuses stay as they were.