{ "openapi": "3.0.1", "info": { "title": "Ohio Contractor License Lookup & Export (OCILB)", "description": "Look up or export every active Ohio OCILB licence — electrical, HVAC, plumbing, hydronics and refrigeration contractors — with company, address, phone and expiry. Filter by trade, county, city, ZIP or name.", "version": "0.0", "x-build-id": "wrY6bqEVfhgDfg3Q7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapebench~ohio-contractor-license-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapebench-ohio-contractor-license-lookup", "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/scrapebench~ohio-contractor-license-lookup/runs": { "post": { "operationId": "runs-sync-scrapebench-ohio-contractor-license-lookup", "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/scrapebench~ohio-contractor-license-lookup/run-sync": { "post": { "operationId": "run-sync-scrapebench-ohio-contractor-license-lookup", "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": { "trade": { "title": "Trade", "type": "string", "description": "One OCILB trade: EL (electrical), HV (HVAC), HY (hydronics), PL (plumbing), RE (refrigeration) or TA (training agency). Words work too: 'electrical', 'hvac', 'plumbing'. Leave empty for all five contractor trades (training agencies are only returned when asked for). An unrecognised value is ignored with a log line; if nothing you gave is recognised, the run returns a free row saying so instead of the whole state." }, "trades": { "title": "Trades (batch)", "type": "array", "description": "Several trades in ONE run, e.g. EL and PL. Combined with 'Trade' if you fill both.", "default": [], "items": { "type": "string" } }, "status": { "title": "Licence status", "enum": [ "all", "active", "active_in_renewal" ], "type": "string", "description": "OCILB's roster lists only live licences. 'all' returns both ACTIVE and ACTIVE IN RENEWAL (a licence inside its renewal window); pick one to narrow it.", "default": "all" }, "county": { "title": "County", "type": "string", "description": "Ohio county of the LICENCE HOLDER as OCILB records it, e.g. 'Cuyahoga' or 'Franklin County'. Matches Ohio holders only. An unrecognised county is ignored with a log line." }, "counties": { "title": "Counties (batch)", "type": "array", "description": "Several Ohio counties in ONE run. Combined with 'County' if you fill both.", "default": [], "items": { "type": "string" } }, "city": { "title": "City", "type": "string", "description": "Company city, exact match ignoring case and punctuation, e.g. 'Columbus' (does not also match 'Columbus Grove')." }, "cities": { "title": "Cities (batch)", "type": "array", "description": "Several company cities in ONE run. Combined with 'City' if you fill both.", "default": [], "items": { "type": "string" } }, "zip": { "title": "ZIP code", "type": "string", "description": "Company ZIP, 5 digits (a ZIP+4 is accepted and matched on its first 5)." }, "zips": { "title": "ZIP codes (batch)", "type": "array", "description": "Several company ZIPs in ONE run. Combined with 'ZIP code' if you fill both.", "default": [], "items": { "type": "string" } }, "name": { "title": "Name contains", "type": "string", "description": "Text that the licensee's name or the company name contains (case-insensitive), e.g. 'MECHANICAL' or 'SMITH'." }, "names": { "title": "Names (batch)", "type": "array", "description": "Several name fragments in ONE run; a licence matching any of them is returned once. The run log says how many licences each one matched.", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Cap on licences returned for the whole run (a spend control). The full statewide roster is about 12,200 contractor licences, so 100000 returns everything that matches. The run log states how many matched when the cap cuts it short.", "default": 500 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. The OCILB site answers direct requests; enable a proxy only if runs come back with a 'blocked' notice.", "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 } } } } } } } } } }