{ "openapi": "3.0.1", "info": { "title": "US Contractor License Registry Scraper", "description": "Scrapes US government contractor licensing registries in 12 states, capturing business names, license numbers, types, specialties, status, addresses, phone numbers, and dates. Features filters for state, city, and license status, including Oregon bond info and New York compliance records.", "version": "0.0", "x-build-id": "eUxDxQJOw0Bcg2J4g" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/moving_beacon-owner1~us-contractor-license-registry-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-moving_beacon-owner1-us-contractor-license-registry-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/moving_beacon-owner1~us-contractor-license-registry-scraper/runs": { "post": { "operationId": "runs-sync-moving_beacon-owner1-us-contractor-license-registry-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/moving_beacon-owner1~us-contractor-license-registry-scraper/run-sync": { "post": { "operationId": "run-sync-moving_beacon-owner1-us-contractor-license-registry-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": { "states": { "title": "States", "type": "string", "description": "Comma-separated two-letter states to search. Supported: WA (Washington L&I plus the City of Seattle), OR (Oregon CCB and Building Codes Division), NY (New York State DOL contractor, elevator and mold registries, plus NYC Buildings and Consumer & Worker Protection), CT (Connecticut Dept. of Consumer Protection — home improvement, new home construction, electrical, plumbing, heating and cooling, sheet metal, fire protection, elevator and more), CA (City of Los Angeles registered construction and specialty-trade businesses), CO (Colorado DORA electrical and plumbing), TX (Texas Department of Licensing and Regulation statewide, plus the City of Dallas register), IL (Illinois DPH asbestos and lead, plus City of Chicago home repair), LA (City of New Orleans occupational licences held by building trades), MO (City of Kansas City business licences held by building trades), MD (Montgomery County electrical, journeyman electrician and fire systems), DE (Delaware DNREC water-well contractors and Delaware Division of Professional Regulation trades).", "default": "WA" }, "city": { "title": "City", "type": "string", "description": "Optional city to filter on, e.g. 'Seattle'. Matched as a case-insensitive substring against the city the business registered with the licensing authority.", "default": "" }, "business_name": { "title": "Business name contains", "type": "string", "description": "Optional text that the registered business name must contain, e.g. 'roofing' to find roofing companies, or a specific company name to look one up.", "default": "" }, "specialty": { "title": "Trade specialty contains", "type": "string", "description": "Optional trade or endorsement text to filter on, e.g. 'plumbing', 'electrical', 'residential', 'roofing'. Available wherever the authority publishes a trade field; registries that do not publish one are skipped for this filter rather than returning nothing.", "default": "" }, "status": { "title": "License status contains", "type": "string", "description": "Optional license status filter, e.g. 'Active' or 'Expired'. Matched on whole words, so 'Active' never returns 'Inactive'. Registries that publish only current licences (Oregon CCB, City of Dallas, Los Angeles, Seattle) are treated as Active. Registries that publish no status at all are skipped for this filter rather than returning rows it was never applied to.", "default": "" }, "max_results": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of license records to return across all selected states.", "default": 25 }, "app_token": { "title": "Socrata app token (optional)", "type": "string", "description": "Optional free Socrata app token. Not required — the registries answer without one. Supplying a token only raises the shared rate limit on very large runs." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy. These are US government open-data portals and normally need no proxy; enable one only for very large runs.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }