Maryland MHIC Home Improvement Contractor License Scraper

Here is one real result, with every field the actor returns:

{
  "name": "ALEX JOSUE AMBROCIO AMBROCIO",
  "businessName": "A & J RENOVATION LLC",
  "licenseNumber": "05-159800",
  "registrationNumber": "159644",
  "suffix": null,
  "category": "CONTRACTOR/SALESMAN",
  "status": "Active",
  "expiration": "2028-08-11",
  "addressStreet": "7912 LANSDALE RD",
  "city": "BALTIMORE",
  "state": "MD",
  "zip": "21224",
  "searchType": "city",
  "searchQuery": "BALTIMORE",
  "source": "Maryland MHIC (Home Improvement Commission)",
  "observedAt": "2026-08-10T14:37:48.923Z"
}

The most complete Maryland MHIC license scraper available. It returns every field the Home Improvement Commission license record exposes, including business name, registration and license numbers, category, status, expiration and full business address, and lets you search by city, contractor last name, business name, registration number or salesperson last name in one run.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor queries the Maryland Home Improvement Commission (MHIC) license database, runs each search you pass (by city, contractor last name, business name, registration number, or salesperson last name), and writes one normalized record per active licensee to the run's dataset. Each record carries the licensee name, business name, registration and license numbers, category, status, expiration date and full business address. Multiple searches run in the same run under a single shared maxResults cap, and missing source values are returned as null.

Quickstart

Open the actor, paste this into the input, and press Run. It returns active MHIC-licensed contractors located in Baltimore.

{
  "cities": ["BALTIMORE"],
  "maxResults": 10
}

Combine or swap in lastNames, businessNames, registrationNumbers, or salespersonLastNames to run other searches in the same run. Use filterCity to narrow name-based searches to one city.

Input reference

Field	Type	Required	Default	Description
cities	string[]	no	["BALTIMORE"]	Return all active MHIC licensees whose business is located in these Maryland cities. One run does every city.
lastNames	string[]	no	(none)	Search active licensed contractors by personal last name, for example SMITH.
businessNames	string[]	no	(none)	Search active licensees by business or trade name (partial matches allowed), for example CONSTRUCTION, ROOFING.
registrationNumbers	string[]	no	(none)	Look up specific licensees by MHIC registration number. Do not include the dash suffix.
salespersonLastNames	string[]	no	(none)	Search active licensed salespersons by last name.
filterCity	string	no	(empty)	Optional city to narrow the last-name, business-name and salesperson searches. Empty searches statewide.
maxResults	integer	no	50	Maximum licensee records to return across all searches. Free Apify plans are capped at 10 per run.

Output reference

One dataset item per licensee. Types: string or null when the source value is absent.

Field	Type	Description
name	string	Licensee personal name.
businessName	string	Business or trade name.
licenseNumber	string	MHIC license number (with prefix), for example 05-159800.
registrationNumber	string	MHIC registration number.
suffix	string	License suffix, or null.
category	string	License category, for example CONTRACTOR/SALESMAN.
status	string	License status, for example Active.
expiration	string	License expiration date (YYYY-MM-DD).
addressStreet	string	Business street address.
city	string	Business city.
state	string	Business state (MD).
zip	string	Business ZIP code.
searchType	string	Which search produced the record: city, lastName, businessName, registrationNumber, or salesperson.
searchQuery	string	The search term that matched this record.
source	string	Always Maryland MHIC (Home Improvement Commission).
observedAt	string	ISO 8601 timestamp of when the record was collected.

On a failed run, a single item with a populated error field is written instead, and it is not charged.

Example output record

Real record from a live run (input {"cities": ["BALTIMORE"], "maxResults": 10}):

{
  "name": "ALEX JOSUE AMBROCIO AMBROCIO",
  "businessName": "A & J RENOVATION LLC",
  "licenseNumber": "05-159800",
  "registrationNumber": "159644",
  "suffix": null,
  "category": "CONTRACTOR/SALESMAN",
  "status": "Active",
  "expiration": "2028-08-11",
  "addressStreet": "7912 LANSDALE RD",
  "city": "BALTIMORE",
  "state": "MD",
  "zip": "21224",
  "searchType": "city",
  "searchQuery": "BALTIMORE",
  "source": "Maryland MHIC (Home Improvement Commission)",
  "observedAt": "2026-08-10T14:37:48.923Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~maryland-mhic-contractors-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"cities":["ROCKVILLE"],"maxResults":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~maryland-mhic-contractors-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"businessNames":["ROOFING"],"filterCity":"BALTIMORE","maxResults":100}'

Apify CLI:

apify call scrapers_lat/maryland-mhic-contractors-scraper \
  --input '{"registrationNumbers":["159644"]}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per record returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxResults.

FAQ and troubleshooting

A run returned 0 records. Why? The search matched no active licensees. Widen the term (a partial business name matches more), remove filterCity, or try another city. Zero-result runs are not charged.

Can I run several searches at once? Yes. Fill any combination of cities, lastNames, businessNames, registrationNumbers and salespersonLastNames; all run in the same run under one shared maxResults cap.

How do I look up one specific license? Pass its number in registrationNumbers (without the dash suffix).

Does it return inactive or expired licenses? The source searches surface active licensees. The status and expiration fields let you confirm each record.

Is this an official Maryland MHIC tool? No. This actor is independent and has no affiliation with the Maryland Home Improvement Commission. It reads only data that is publicly available through the MHIC license lookup.

Related scrapers

• California CSLB Scraper: California contractor state license board records.
• Alabama LBGC Contractors Scraper: Alabama licensed general contractors.
• Louisiana LSLBC Contractors Scraper: Louisiana licensed contractors.
• Florida DBPR Scraper: Florida professional and business licenses.
• Chicago Building Permits Scraper: Chicago building permit records.
• ASC Appraisers Scraper: US appraiser license records.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with the Maryland Home Improvement Commission. Accesses only publicly available data.