US City Building Permit Lead Feed for Roofing/HVAC

Find contractor lead signals from public planning, permit, municipal, renovation, construction, roofing, HVAC, solar, or building sources with location, work type, stage, source URL, and confidence.

What this Actor does

What it does

• Processes configured public sources or user-provided records for focused us city building permit lead for roofing/hvac monitoring.
• Emits structured rows with source references, stable identifiers, confidence, warnings, and run summary fields.
• Supports sample-mode runs so Apify Store QA and first-time users can inspect output without depending on live third-party availability.

What it does not do

• Does not scrape private, login-only, paywalled, or access-restricted data unless the user provides approved credentials for a source they control.
• Does not guarantee every field is available from every source; missing or blocked fields are returned as warnings or nulls.
• Does not make legal, financial, compliance, procurement, medical, safety, or regulatory decisions.

Who this is for

Contractors, suppliers, solar, roofing, HVAC, construction, and local sales teams use this actor when they need focused us city building permit lead for roofing/hvac output instead of a broad generic scraper or manual checking.

Buyer outcomes

• Find us city building permit lead for roofing/hvac project signals earlier than manual planning and permit searches.
• Prioritize outreach with location, work type, permit stage, contractor opportunity, confidence, and source URL.
• Route qualified leads into CRM, sales research, local territory, or partner workflows.

Data sources

Sources monitored

public planning, permit, municipal, renovation, construction, roofing, HVAC, solar, or building sources

Input

• sourceMode: use sample for a smoke run or startUrls for planning/permit source URLs.
• startUrls: public planning authority, permit, renovation, construction, roofing, HVAC, solar, or building-source URLs.
• sourceIds: approved planning or municipal source identifiers.
• maxItems: bounded number of permit/planning lead signals to return.
• sinceLastRun: emit only new or updated planning/permit signals when scheduled.
• watchlistTerms: location, work type, building type, contractor trade, or project keywords.
• webhookUrl: optional destination for CRM or contractor lead routing.

How it transforms the input

• Input: public planning authority, building permit, renovation, roofing, HVAC, solar, municipal, or construction source.
• Transformation: identify project type, work type, planning/permit stage, location, and contractor relevance.
• Output: contractor lead with planning authority, project location, work type, stage/status, source URL, opportunity type, and confidence.

Output

The actor returns planning and permit lead records with authority/source, location, project type, work type, permit stage, contractor opportunity type, source URL, and confidence.

Family-specific fields to expect:

• permitId: Permit, planning, or application identifier when available.

• planningStatus: Planning, submitted, approved, consultation, or other source status.

• location: Project location or municipality.

• workType: Roofing, HVAC, solar, renovation, construction, or other work type.

• projectType: Building or project category.

• contractorLeadReason: Why the record is relevant to a contractor or supplier.

• sourceUrl: Public source record URL.

• recordId: Stable record ID for exports, dedupe, and downstream joins.

• title: Human-readable record title for review and export.

• sourceName: Source identifier used to trace where the record came from.

• sourceUrl: Direct source URL for review and audit.

• dedupeKey: Stable key used for delta mode and duplicate suppression.

• retrievedAt: Timestamp showing when the actor retrieved or generated this record.

• score: Normalized field for filtering, routing, or downstream review.

• scoreReasons: Buyer-readable explanation for the score or match.

• confidence: Normalized field for filtering, routing, or downstream review.

• errors: Normalized field for filtering, routing, or downstream review.

• runSummary: Run-level summary for counts, filters, charges, and next actions.

Pricing

This actor uses Apify pay-per-event pricing. Current public listing guidance: $29-$49 / 1,000 launch validation records until public data proof is complete. Charges are tied to buyer-visible value events such as qualified-permit-lead, dataset-processed, record-saved, enriched-record. Small validation runs are supported so you can inspect output before scaling a schedule.

• qualified-permit-lead: Charge once after a unique buyer-ready output passes the product-specific contract. Typical price: $0.040. A run that produces 10 matching records charges only for the matched buyer-value events and remains capped by the run limit.
• dataset-processed: Base charge when US City Building Permit Lead Feed for Roofing/HVAC writes a non-empty default dataset. Typical price: $0.011. A run that produces 10 matching records charges only for the matched buyer-value events and remains capped by the run limit.
• record-saved: Charge for each buyer-visible result saved by US City Building Permit Lead Feed for Roofing/HVAC. Typical price: $0.003. A run that produces 10 matching records charges only for the matched buyer-value events and remains capped by the run limit.
• enriched-record: Charge when US City Building Permit Lead Feed for Roofing/HVAC adds match scoring, source evidence, or enrichment to a saved result. Typical price: $0.022. A run that produces 10 matching records charges only for the matched buyer-value events and remains capped by the run limit.
• first-run-cap: Recommended first run budget cap. Typical price: $3.820. Start with the default small run, inspect the dataset, then raise maxItems or schedule recurring runs.

API example

curl -X POST "https://api.apify.com/v2/actors/zentrafoundry~us-building-permit-roofing-hvac-leads/runs" \
+  -H "Authorization: Bearer $APIFY_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d '{"maxItems":10,"sourceIds":[],"includeSourceUrls":true,"includeMatchReasons":true,"outputMode":"buyer-ready-records"}'

Demo run

Recommended first run

{
    "maxItems": 10,
    "sourceIds": [],
    "includeSourceUrls": true,
    "includeMatchReasons": true,
    "outputMode": "buyer-ready-records"
}

Sample output

Sample status: sample_unavailable at https://zentra.nimblique.studio/external/actor-review/samples/us-building-permit-roofing-hvac-leads.json. No fake sample is published; run a bounded real sample refresh before using examples in promotion.

Recommended public tasks

[
    {
        "name": "Review 10 permit lead signals",
        "description": "Low-cost validation run for checking planning authority, location, work type, and stage fields.",
        "input": {
            "maxItems": 10,
            "sourceIds": [],
            "includeSourceUrls": true,
            "includeMatchReasons": true,
            "outputMode": "buyer-ready-records",
            "actorSlug": "us-building-permit-roofing-hvac-leads"
        }
    },
    {
        "name": "Daily permit lead review",
        "description": "Recurring batch for new planning, building, roofing, HVAC, solar, or renovation leads.",
        "schedule": "Daily during local business hours",
        "input": {
            "maxItems": 25,
            "sourceIds": [],
            "includeSourceUrls": true,
            "includeMatchReasons": true,
            "outputMode": "buyer-ready-records",
            "actorSlug": "us-building-permit-roofing-hvac-leads"
        }
    }
]

Example use cases

• Find us city building permit lead for roofing/hvac project signals before they become crowded sales opportunities.
• Route qualified permit and planning records into CRM or contractor outreach queues.
• Filter by work type, location, stage, confidence, and source evidence.
• Schedule recurring monitoring for new renovation, HVAC, roofing, solar, or construction leads.

Trust and compliance

• Uses public planning, permit, municipal, renovation, construction, roofing, HVAC, solar, or building sources.
• Keeps source URLs and source identifiers in output records for auditability.
• Does not require private credentials unless a source is explicitly configured for approved authenticated access.

Reliability and QA

• Prefilled Apify Store QA input runs in sample mode and should finish within the automated quality window.
• Empty input is handled with deterministic sample or diagnostic output instead of a crash.
• Demo/sample runs suppress buyer-value charges while still writing representative dataset rows.
• Production runs use bounded maxItems, source references, warnings, and run summaries so blocked or changed targets are visible.

Limitations

• Results depend on public-source availability, source uptime, and source update cadence.
• Public sources can revise records after publication; rerun scheduled tasks for fresh evidence.
• Scores and match reasons are decision-support signals, not legal, financial, procurement, medical, safety, or regulatory advice.
• Large production runs can cost more than the default smoke run; start small, inspect output, then scale schedules.

Legal and responsible use

Use this Actor only for public data or data you are authorized to process. You are responsible for complying with applicable laws, marketplace terms, robots policies, privacy rules, and source-specific limits.

Support

Open an issue on the Actor page with the run ID, input summary, expected result, and observed result. Do not include secrets, cookies, auth headers, or private account data.

FAQ

Can I run this without URLs? Yes. The default sample mode is designed to succeed without user-supplied URLs, and URL-backed runs can use startUrls when needed.

Can I schedule it? Yes. Use sinceLastRun, watchlistTerms, and optional webhookUrl to turn the actor into a recurring alert or report workflow.

How do I verify value before scaling? Run the recommended first-run input, review the sample output fields, then increase maxItems or schedule recurring runs after the dataset matches your use case.