{ "openapi": "3.0.1", "info": { "title": "New York Professional License Lookup & Verification Scraper", "description": "Look up and verify New York professional licenses with no API key. Search the NYSED Office of the Professions by name or license number across 90+ professions (doctors, nurses, PE, CPA, pharmacists, dentists). Get status, registration dates, school and enforcement. Batch or single lookups.", "version": "0.1", "x-build-id": "QB8emcXgVmAcCRqVQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~ny-professions-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-ny-professions-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/scrapers_lat~ny-professions-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-ny-professions-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/scrapers_lat~ny-professions-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-ny-professions-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", "properties": { "maxLicensees": { "title": "Max Licensees", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of licensee records to collect. Optional." }, "query": { "title": "Search query (name or license number)", "type": "string", "description": "A licensee last name (for example smith), a full name (for example smith john), or a license number (digits only, for example 099740). When you enter a license number, also pick a specific profession below so the exact license can be resolved." }, "profession": { "title": "Profession", "enum": [ "ALL", "007", "008", "025", "003", "067", "057", "078", "049", "048", "091", "085", "070", "094", "092", "090", "CN", "005", "093", "051", "069", "084", "050", "059", "079", "083", "082", "081", "060", "061", "016", "095", "014", "015", "004", "073", "071", "006", "072", "018", "010", "019", "027", "009", "011", "012", "013", "028", "022", "029", "043", "030", "031", "032", "033", "034", "045", "035", "036", "037", "044", "038", "039", "040", "041", "042", "064", "063", "055", "056", "089", "086", "020", "021", "002", "062", "066", "023", "065", "026", "088", "068", "024", "052", "053", "058", "075", "074", "076", "077" ], "type": "string", "description": "Restrict the search to one licensed profession. Leave as All Professions to search across every profession (best for less common names). A specific profession is required to look up a license number, and makes name searches for common names faster.", "default": "ALL" }, "queries": { "title": "Batch queries (optional)", "type": "array", "description": "Optional. Look up many licensees in one run. Each item is a last name, a full name, or a license number (as a string), or an object like {\"query\": \"099740\", \"profession\": \"060\"} to scope that item to a specific profession. Falls back to the Profession field above when an item has none. The competitor fields licenseeNames and licenseNumbers are also accepted. Leave empty to use the single Search query below." }, "status": { "title": "Registration status filter", "type": "string", "description": "Optional. Keep only records whose status contains this text, case-insensitive (for example Registered). Leave empty to keep every status." }, "withDetails": { "title": "Fetch full details (status and registration dates)", "type": "boolean", "description": "When on (recommended), each matched licensee is enriched with the registration status, the registered-through date, qualifications and school. Turn off for a faster, lighter run that returns only the name, profession, license number, city, state and licensure date from the results list.", "default": true } } }, "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 } } } } } } } } } }