Illinois Roofing Contractor Directory & Leads Scraper (IDFPR)

Pain points

• Illinois publishes its roofing contractor license data through a Socrata open-data portal with no built-in export — there is no 'Download CSV' button for a county-filtered slice.
• Searching the IDFPR online license lookup returns one page at a time with no bulk option, making it impractical to build a full county roster.
• Roofing sales teams, suppliers, and compliance teams have no easy way to get a clean list of all active (and expired) IDFPR roofing licenses in a target county.

What we solve

• Queries the official IDFPR Socrata dataset directly and pages through all roofing contractor records for any Illinois county in one run.
• Returns every IDFPR roofing contractor in the county: business name, license number, license type, status, expiration date, city, and ZIP.
• Discovery Mode lists all valid Illinois counties with roofing contractor records in seconds so you always know the exact county name to use.

Summary

Export every IDFPR-licensed roofing contractor in any Illinois county straight from the official state open-data registry. Pick a county (e.g. COOK, DUPAGE, KANE), run the actor, and get a clean dataset of every roofing licensee — business name, license number, description, status, expiration date, city, and ZIP. Discovery Mode lists all counties with records in seconds. Note: Illinois has no statewide general-contractor license; roofing is the only contractor trade licensed at the state level (IDFPR). Street address and phone are not published in the IDFPR dataset.

Who it's for

• Roofing material suppliers and distributors building county-level prospect lists
• Sales reps targeting roofing contractors for tools, coatings, or insurance products
• General contractors and property managers finding certified roofing subs in a county
• Compliance and risk teams monitoring IDFPR roofing license status at scale
• Market researchers auditing active vs expired roofing licenses by county

How to use

Set the input, run the actor, and collect results from the run's dataset (export to JSON/CSV/Excel, or pull via the Apify API). Example input:

{
  "county": "COOK",
  "maxResults": 500
}

See Inputs below for every available field.

What you get

One row per record:

Field	Description
state	Always 'IL'
license_number	IDFPR license number (e.g. 104012345). May be null for historical/deceased records.
business_name	Licensed business or individual licensee name
license_type	IDFPR license description (e.g. LICENSED ROOFING CONTRACTOR or QUALIFYING PARTY ROOFING CONTRACTOR)
status	License status (ACTIVE, NOT RENEWED, CANCELLED, DECEASED)
issue_date	Original issue date (MM/DD/YYYY)
expiration_date	License expiration date (MM/DD/YYYY)
city	Licensee city
county	Illinois county from the scrape filter
zip_code	ZIP code
person_name	Full person name for individual (non-business) licensees; null for businesses
address	Street address — not available in the IDFPR dataset; always null
phone	Phone number — not available in the IDFPR dataset; always null
matched_by	Always 'county_directory' in Scrape Mode
source_url	Link to the IDFPR dataset page on data.illinois.gov

Sample:

{
  "state": "IL",
  "license_number": "104012345",
  "business_name": "CHICAGO SKYLINE ROOFING INC",
  "license_type": "LICENSED ROOFING CONTRACTOR",
  "status": "ACTIVE",
  "issue_date": "03/15/2010",
  "expiration_date": "06/30/2025",
  "city": "CHICAGO",
  "county": "COOK",
  "address": null,
  "zip_code": "60601",
  "phone": null,
  "person_name": null,
  "bond_amount": null,
  "bond_company": null,
  "insurance_company": null,
  "matched_by": "county_directory",
  "source_url": "https://data.illinois.gov/d/pzzh-kp68"
}

Inputs

Field	Required	Type	Default	Description
listCountiesOnly	no	boolean	false	When true, the actor returns all available Illinois counties that have IDFPR roofing contractor records and exits immediately (< 10 seconds, no charge). Use this to discover the exact county name before running a full scrape.
county	no	string	"COOK"	The Illinois county to scrape — full name in uppercase (e.g. 'COOK', 'DUPAGE', 'KANE'). Required in Scrape Mode. Run with listCountiesOnly=true to see all available county names.
maxResults	no	integer	500	Hard cap on the number of roofing contractor records returned. Cook County alone has thousands of records; set lower for testing. Default 500.

Pricing (Pay Per Event)

You pay per result (dataset-item) — no charge for empty runs. Example: 500 roofing contractor records at $0.002/result ≈ $1.00.

Illustrative — the final per-result price is set at publish time. Apify platform usage (compute) is billed separately per your plan. Discovery Mode (listCountiesOnly=true) returns county names only and is not charged.

Use cases

• Lead list building — export all IDFPR roofing contractors in Cook or DuPage County into a CRM or outreach sequence.
• Supplier prospecting — find every licensed roofing contractor in a target county before a territory sales push.
• Compliance monitoring — pull the full county roster monthly and flag any status changes (ACTIVE → NOT RENEWED).
• Market sizing — count active licenses by county to gauge roofing contractor density before opening a new branch.
• Subcontractor vetting — verify a roofing sub is IDFPR-licensed and in good standing before awarding a contract.

Why this actor

• Data sourced directly from the official IDFPR Socrata open-data registry — authoritative, not a stale third-party copy.
• Discovery Mode lists all Illinois counties with roofing contractor records in seconds so you never have to guess the county name.
• Handles full county rosters of thousands of records via automatic pagination — no manual page-clicking.
• Pay per record; no charge for Discovery Mode runs or empty results.
• Covers all IDFPR roofing license types: LICENSED ROOFING CONTRACTOR and QUALIFYING PARTY ROOFING CONTRACTOR.

Limitations & updates

Covers IDFPR roofing contractor licenses only (license_type='ROOFING CONTRACTOR'). Illinois has no statewide general-contractor, electrical, or plumbing license — those are municipal. Street address and phone fields are null (not published by IDFPR). Approximately 15% of historical records have blank or out-of-state county values; these are filtered out in Discovery Mode and excluded when scraping by county. The IDFPR dataset includes both active and all historical/expired/cancelled licenses.

FAQ

Where does the data come from?

The Illinois Department of Financial and Professional Regulation (IDFPR) publishes its license data on data.illinois.gov (Socrata dataset pzzh-kp68). This actor queries that public dataset directly.

Why does this only cover roofing contractors?

Illinois has no statewide general-contractor license. Roofing contractor is the only contractor-trade license issued at the state level by IDFPR. Electrical, plumbing, HVAC, and general construction are licensed at the municipal level, not by IDFPR.

How do I find the right county name?

Run the actor once with listCountiesOnly=true. It returns all available Illinois county names in seconds at no charge.

How many records can I get per run?

Cook County alone has thousands of roofing contractor records spanning active, expired, and historical licenses. The actor paginates automatically; set maxResults to control the cap.

Why are address and phone null?

The IDFPR dataset does not publish street address or phone number fields — only city, state, ZIP, and county. The actor sets these fields to null for schema consistency with the rest of the contractor suite.

How am I charged?

Pay per record in Scrape Mode. Discovery Mode (listCountiesOnly=true) is not charged.

How current is the data?

The IDFPR dataset is updated regularly by the state. The actor queries the live dataset at scrape time.

Which actor to choose

Part of the contractor data suite — pick the one that fits your goal:

• Florida Contractor Directory & Leads Scraper (DBPR) — You want the same county-scoped contractor directory for Florida (DBPR) — general, building, and specialty contractors.
• California Contractor License Lookup & Verify (CSLB) — You need a California contractor verified — by license number, business, or owner/personnel name (CSLB).
• Texas Contractor Directory & Leads Scraper (TDLR) — You want the same county-scoped directory for Texas contractors (TDLR).
• Multi-State Contractor & Trade License Lookup — You need contractor data across multiple states in one run.