{ "openapi": "3.0.1", "info": { "title": "Alabama Commercial Contractor Directory & Leads (LBGC)", "description": "Every LBGC-licensed commercial contractor and subcontractor in an Alabama county, by classification — business name, phone, fax, mailing address, ZIP, licence, classifications and bid limit.", "version": "0.0", "x-build-id": "KzAST6AsNoESXIIoG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapebench~alabama-contractor-directory-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapebench-alabama-contractor-directory-leads-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/scrapebench~alabama-contractor-directory-leads-scraper/runs": { "post": { "operationId": "runs-sync-scrapebench-alabama-contractor-directory-leads-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/scrapebench~alabama-contractor-directory-leads-scraper/run-sync": { "post": { "operationId": "run-sync-scrapebench-alabama-contractor-directory-leads-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": { "listOptionsOnly": { "title": "Discovery Mode: list counties and classifications only", "type": "boolean", "description": "If true, skip the search and return the 67 Alabama counties plus every classification code on the Alabama Licensing Board for General Contractors (LBGC) roster, with how many licensees hold it. Free, not charged.", "default": false }, "trade": { "title": "Classification / trade", "type": "string", "description": "An LBGC classification code, e.g. 'BC' (Building Construction), 'MU' (Municipal and Utility), 'HS' (Highways and Streets), 'BC-S' or 'SUBCONTRACTOR' — a code matches exactly, so 'BC' does not include 'BC-S'. Or a word: 'electrical', 'paving', 'plumbing' finds every classification whose description contains a word starting with it. Leave empty for every classification in the county." }, "trades": { "title": "Classifications (batch)", "type": "array", "description": "Several classifications in ONE run, e.g. BC and MU and electrical. Combined with 'Classification / trade' if you fill both. A contractor matching two of them is returned (and billed) once.", "default": [], "items": { "type": "string" } }, "county": { "title": "County", "type": "string", "description": "Alabama county, e.g. 'Jefferson', 'Mobile County', 'saint clair'. LBGC publishes no county, so this matches the county derived from each contractor's MAILING ZIP or city. If it is not an Alabama county, the run returns the free county and classification lists instead of failing." }, "counties": { "title": "Counties (batch)", "type": "array", "description": "Several counties in ONE run, e.g. Jefferson and Shelby. Combined with 'County' if you fill both.", "default": [], "items": { "type": "string" } }, "includeOutOfState": { "title": "Include out-of-state licensees", "type": "boolean", "description": "LBGC licenses firms from every state: 4,729 of its 8,917 licensees (53%, 2026-10-06) have a mailing address outside Alabama. Off by default. Only applies when no county is set — a county search is always Alabama addresses.", "default": false }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Cap on the contractors returned PER county + classification search, not per run, so adding counties can never silently truncate the ones later in the list. Leave empty to return every match." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. LBGC 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 } } } } } } } } } }