# Michigan LARA Professional License Lookup Scraper (`automation-lab/michigan-lara-professional-license-lookup-scraper`) Actor Search Michigan LARA / MiPLUS professional license records for compliance checks, recruiting workflows, and licensed-professional lead lists. - **URL**: https://apify.com/automation-lab/michigan-lara-professional-license-lookup-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Michigan LARA Professional License Lookup Scraper Scrape Michigan LARA / MiPLUS professional license lookup records from the public Accela portal. Use it to verify license numbers, monitor license status, and build Michigan licensed-professional lead lists. ### What does Michigan LARA Professional License Lookup Scraper do? This Apify Actor searches the public Michigan Department of Licensing and Regulatory Affairs (LARA) license lookup page and returns structured license records. It submits bounded search queries to the Accela Citizen Access portal and extracts the visible result table. Use it for repeatable checks instead of copying rows from the web interface by hand. ### Who is it for? - ✅ Compliance teams verifying professional licenses before onboarding vendors or employees. - ✅ Background-check providers enriching candidate review workflows. - ✅ Recruiters sourcing licensed professionals in Michigan. - ✅ B2B sales teams building regulated-industry lead lists. - ✅ Data teams that need scheduled license-status monitoring. ### Why use this actor? Manual lookups are slow and hard to audit. The actor gives you consistent JSON, CSV, Excel, XML, or API output from the same public source. You can schedule it, call it from your backend, or connect it to automation tools. ### Data source The actor uses the public Michigan LARA / MiPLUS Accela licensee search page. Source URL: `https://aca-prod.accela.com/MILARA/GeneralProperty/PropertyLookUp.aspx?isLicensee=Y` No login is required for the public search result fields. ### What data can I extract? | Field | Description | | --- | --- | | `licenseType` | LARA license type or profession label | | `licenseNumber` | Public license number | | `firstName` | Licensee first name when present | | `middleInitial` | Middle initial when present | | `lastName` | Licensee last name when present | | `fullName` | Combined person name or organization fallback | | `organizationName` | Organization/business name | | `dbaTradeName` | DBA or trade name | | `licenseStatus` | Public status text from the lookup table | | `expirationDate` | Expiration date when listed | | `detailPostbackTarget` | Accela detail postback target for traceability | | `sourceUrl` | Public lookup page URL | | `query` | Search query that produced the row | | `scrapedAt` | ISO timestamp of extraction | ### How much does it cost to scrape Michigan LARA license records? The actor uses pay-per-event pricing. You pay a small start fee per run plus a per-record charge for each saved license row. Use narrow queries first, then scale up after validating the output. ### Input overview Provide one or more search queries. Each query can include a license number, former license number, first name, last name, organization name, DBA/trade name, or license type. The default example searches two common last names and saves up to 100 records. ### Example input ```json { "queries": [ { "lastName": "Smith" }, { "lastName": "Johnson" }, { "licenseNumber": "1101001085" } ], "maxItems": 100 } ```` ### Search tips - Use `licenseNumber` when you need verification for one known credential. - Use `lastName` and `firstName` for person searches. - Use `organizationName` for business license checks. - Use `licenseType` to reduce noisy broad surname searches. - Add multiple queries when you need more than one page of leads. ### Output example ```json { "licenseType": "Accountant - Licensed", "licenseNumber": "1101004665", "firstName": "Melvyn", "middleInitial": "L", "lastName": "Smith", "fullName": "Melvyn L Smith", "organizationName": null, "dbaTradeName": null, "licenseStatus": "Superseded", "expirationDate": null, "sourceUrl": "https://aca-prod.accela.com/MILARA/GeneralProperty/PropertyLookUp.aspx?isLicensee=Y" } ``` ### How to run the scraper 1. Open the actor on Apify. 2. Add one or more license lookup queries. 3. Set `maxItems` to the number of records you need. 4. Click **Start**. 5. Export the dataset in JSON, CSV, Excel, XML, RSS, or HTML. ### Integrations Use this actor with: - CRM enrichment workflows for licensed Michigan contacts. - Compliance dashboards that flag expired or inactive licenses. - Applicant tracking systems for credential verification. - Data warehouses that store periodic license snapshots. - Lead-scoring pipelines for professional services outreach. ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/michigan-lara-professional-license-lookup-scraper').call({ queries: [{ lastName: 'Smith' }], maxItems: 50, }); console.log(run.defaultDatasetId); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('automation-lab/michigan-lara-professional-license-lookup-scraper').call(run_input={ 'queries': [{'lastName': 'Smith'}], 'maxItems': 50, }) print(run['defaultDatasetId']) ``` ### API usage with cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/automation-lab~michigan-lara-professional-license-lookup-scraper/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"queries":[{"lastName":"Smith"}],"maxItems":50}' ``` ### MCP integration Connect the actor to Claude Desktop, Claude Code, or other MCP clients through Apify MCP. MCP URL: `https://mcp.apify.com/?tools=automation-lab/michigan-lara-professional-license-lookup-scraper` #### Claude Code MCP setup ```bash claude mcp add apify-michigan-lara --url "https://mcp.apify.com/?tools=automation-lab/michigan-lara-professional-license-lookup-scraper" ``` #### Claude Desktop MCP JSON config ```json { "mcpServers": { "apify-michigan-lara": { "url": "https://mcp.apify.com/?tools=automation-lab/michigan-lara-professional-license-lookup-scraper" } } } ``` Example prompts: - "Check whether this Michigan license number appears in LARA." - "Create a CSV of Michigan professional licenses for these surnames." - "Monitor these organization names weekly and alert me if status changes." ### Scheduling Schedule the actor daily, weekly, or monthly to monitor license status changes. Save each run dataset for audit history. Compare `licenseNumber`, `licenseStatus`, and `expirationDate` across snapshots. ### Limitations The MVP extracts the first visible results page for each query. The Accela portal may show 50 rows per query page. For larger lead lists, split your search into multiple targeted queries. ### Reliability notes The actor preserves session cookies and ASP.NET hidden form state for each submitted search. It uses HTTP requests instead of a full browser to keep runs fast and affordable. If the portal changes its form names or table layout, contact support with a failed run URL. ### Legality and ethical use This actor extracts publicly accessible lookup results. You are responsible for using the data in compliance with applicable laws, LARA terms, privacy rules, and professional licensing regulations. Do not use extracted data for spam, harassment, or unlawful discrimination. ### FAQ #### Does this require a Michigan LARA account? No. The actor uses the public licensee lookup page. #### Can I search by exact license number? Yes. Use the `licenseNumber` field for direct verification. #### Why did I get fewer rows than expected? The public site returns a limited visible result page. Use narrower or additional queries to collect more records. #### Does the actor open detail pages? The current version extracts result-table fields and includes the Accela postback target for traceability. Detail-page enrichment can be added later if needed. ### Related scrapers - https://apify.com/automation-lab/ohio-elicense-professional-license-lookup-scraper - https://apify.com/automation-lab/florida-dbpr-license-verification-scraper - https://apify.com/automation-lab/cslb-california-contractor-license-scraper - https://apify.com/automation-lab/contractor-license-verification-scraper ### Support Open an Apify issue with your run URL, input, expected records, and any missing fields. ### Changelog Initial private build for Michigan LARA professional license lookup extraction. ### Appendix: query design For high-volume workflows, prefer many precise queries over one broad query. Good examples: - Last name plus license type. - Organization name prefix. - Exact license number. - Common surnames split across several scheduled runs. ### Appendix: export formats Apify datasets can be downloaded as JSON, JSONL, CSV, Excel, XML, RSS, or HTML. Use CSV/Excel for spreadsheet review and JSON/JSONL for data pipelines. # Actor input Schema ## `queries` (type: `array`): One or more Michigan LARA license lookup searches. Use narrow name/license filters for faster runs. ## `maxItems` (type: `integer`): Maximum records to save across all queries. The public site returns 50 records per query page; use several queries for larger lead lists. ## Actor input object example ```json { "queries": [ { "lastName": "Smith" }, { "lastName": "Johnson" } ], "maxItems": 20 } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ { "lastName": "Smith" }, { "lastName": "Johnson" } ], "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/michigan-lara-professional-license-lookup-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": [ { "lastName": "Smith" }, { "lastName": "Johnson" }, ], "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/michigan-lara-professional-license-lookup-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "queries": [ { "lastName": "Smith" }, { "lastName": "Johnson" } ], "maxItems": 20 }' | apify call automation-lab/michigan-lara-professional-license-lookup-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/michigan-lara-professional-license-lookup-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Michigan LARA Professional License Lookup Scraper", "description": "Search Michigan LARA / MiPLUS professional license records for compliance checks, recruiting workflows, and licensed-professional lead lists.", "version": "0.1", "x-build-id": "08zlGqCBptCKu0zhM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~michigan-lara-professional-license-lookup-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-michigan-lara-professional-license-lookup-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/automation-lab~michigan-lara-professional-license-lookup-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-michigan-lara-professional-license-lookup-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/automation-lab~michigan-lara-professional-license-lookup-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-michigan-lara-professional-license-lookup-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "queries" ], "properties": { "queries": { "title": "🔎 License search queries", "type": "array", "description": "One or more Michigan LARA license lookup searches. Use narrow name/license filters for faster runs.", "items": { "type": "object", "properties": { "licenseType": { "title": "License type", "type": "string", "description": "Optional exact Accela license type text, for example 'Accountant - Licensed'. Leave blank to search all license types." }, "licenseNumber": { "title": "License number", "type": "string", "description": "Michigan LARA license number to verify." }, "formerLicenseNumber": { "title": "Former license number", "type": "string", "description": "Former license number when known." }, "firstName": { "title": "First name", "type": "string", "description": "Licensee first name filter." }, "lastName": { "title": "Last name", "type": "string", "description": "Licensee last name filter." }, "organizationName": { "title": "Organization name", "type": "string", "description": "Organization/business name filter." }, "dbaTradeName": { "title": "DBA / trade name", "type": "string", "description": "DBA or trade name filter." } } } }, "maxItems": { "title": "Maximum license records", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum records to save across all queries. The public site returns 50 records per query page; use several queries for larger lead lists.", "default": 20 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```