{ "openapi": "3.0.1", "info": { "title": "New Jersey Professional License Search (NJ DCA)", "description": "Verify New Jersey professional licenses from the official NJ Division of Consumer Affairs database — 55 professions incl. nursing, HVACR, electrical, plumbing, home improvement contractors, pharmacy. Search people or businesses by name, license number, or city. Returns status & expiration.", "version": "1.0", "x-build-id": "rddb36KhyeWACAHvu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lulzasaur~nj-license-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lulzasaur-nj-license-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/lulzasaur~nj-license-scraper/runs": { "post": { "operationId": "runs-sync-lulzasaur-nj-license-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/lulzasaur~nj-license-scraper/run-sync": { "post": { "operationId": "run-sync-lulzasaur-nj-license-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": [ "searchMode" ], "properties": { "searchMode": { "title": "Search Mode", "enum": [ "person", "business" ], "type": "string", "description": "Person search looks up individual licensees (first/last name). Business search looks up licensed businesses (business name) — use this for Home Improvement Contractors, Electrical Contractors, cemeteries, etc.", "default": "person" }, "profession": { "title": "Profession", "enum": [ "", "Accountancy", "Acupuncture", "Applied Behavior Analysts", "Approved Hosp. Training Prog.", "Architecture", "Art Therapist Advisory Comm", "Athletic Trainers", "Audiology", "CDS", "Cemetery", "Cert Psychoanalysts Adv Comm", "Chiropractic Examiners", "Cosmetology and Hairstyling", "Court Reporting", "Creative Arts", "Dentistry", "Diet and Nutrition", "EEMW", "Electrical Contractors", "Electrologists", "Engineers & Land Surveyors", "Genetic Counseling", "Hearing Aid Dispensers", "Home Improvement Contractors", "Home Inspection Advisory Comm", "HVACR", "Interior Designers", "Int'l Labor and Matchmaking", "Kosher / Hallal", "Landscape Architecture", "Legalized Games", "Marriage and Family Therapy", "Massage and Bodywork Therapy", "Master Hearth Adv Committee", "Master Plumbers", "Medical Examiners", "Mortuary Science", "Nursing", "Occupational Therapy", "Ophthalmic Dispensers", "Optometry", "Orthotics & Prosthetics", "Perfusionist", "Pharmacy", "Physical Therapy", "Physician Assistants", "Polysomnography", "Professional Planners", "Psychology", "Real Estate Appraisers", "Respiratory Care", "Servicemember Civil Relief Act", "Social Work Examiners", "Veterinary Medical Examiners" ], "type": "string", "description": "NJ DCA board/profession to search within. Leave as All to search every profession.", "default": "" }, "licenseType": { "title": "License Type (optional)", "type": "string", "description": "Narrow to a specific license type within the profession (e.g. \"Reg. Prof. Nurse-Single State\"). Must match a NJ DCA license-type label; partial, case-insensitive matches are resolved automatically.", "default": "" }, "lastName": { "title": "Last Name (person search)", "type": "string", "description": "Licensee last name. Supports % as a wildcard (e.g. \"smi%\").", "default": "" }, "firstName": { "title": "First Name (person search)", "type": "string", "description": "Licensee first name. Supports % as a wildcard.", "default": "" }, "businessName": { "title": "Business Name (business search)", "type": "string", "description": "Business/facility name. Supports % as a wildcard (e.g. \"%construction%\"). Plain text without wildcards is matched exactly, so wildcards are recommended.", "default": "" }, "licenseNumber": { "title": "License Number", "type": "string", "description": "Exact NJ license number (e.g. 26NR00406800).", "default": "" }, "city": { "title": "City", "type": "string", "description": "NJ city filter (e.g. Newark).", "default": "" }, "includeDetails": { "title": "Fetch Detail Pages", "type": "boolean", "description": "Fetch each licensee's detail page for issue date, expiration date, status change reason, and SPL home state. One extra request per record — disable for faster, larger scrapes.", "default": true }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of license records to return. Set to 0 for unlimited (server paginates 40 per page).", "default": 100 } } }, "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 } } } } } } } } } }