{
"openapi": "3.0.1",
"info": {
"title": "Texas Electrician, HVAC & TDLR License Lookup — Bulk Search",
"description": "Search, look up & verify Texas TDLR licenses in bulk — electricians, HVAC, cosmetology, tow, massage & 50+ more trades. Status, expiration, address, phone. Official TDLR data. Export CSV/JSON/Excel.",
"version": "0.1",
"x-build-id": "fWv3qCcaydXND1sWI"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/cblu~texas-license-records-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-cblu-texas-license-records-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/cblu~texas-license-records-scraper/runs": {
"post": {
"operationId": "runs-sync-cblu-texas-license-records-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/cblu~texas-license-records-scraper/run-sync": {
"post": {
"operationId": "run-sync-cblu-texas-license-records-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": [
"profession"
],
"properties": {
"profession": {
"title": "Profession / license program",
"enum": [
"electricians-all",
"master-electricians",
"journeyman-electricians",
"apprentice-electricians",
"electrical-contractors",
"electrical-sign-contractors",
"residential-wiremen",
"maintenance-electricians",
"ac-contractors",
"ac-technicians",
"appliance-installers",
"appliance-installation-contractors",
"barbers-cosmetologists",
"cosmetology-operators",
"class-a-barbers",
"manicurists",
"estheticians",
"beauty-establishments",
"cosmetology-schools",
"barber-schools",
"auctioneers",
"boiler-inspectors",
"elevator-inspectors",
"elevator-contractors",
"licensed-breeders",
"property-tax-consultants",
"property-tax-professionals",
"accessibility-specialists",
"service-contract-providers",
"professional-employer-organizations",
"tow-truck-operators",
"tow-truck-companies",
"vehicle-storage-facilities",
"used-auto-parts-recyclers",
"water-well-drillers",
"motor-fuel-metering",
"behavior-analysts",
"massage-therapists",
"massage-establishments",
"massage-schools",
"mold-assessment-companies",
"mold-assessment-consultants",
"mold-remediation-companies",
"mold-remediation-contractors",
"mold-remediation-workers",
"dietitians",
"athletic-trainers",
"speech-language-pathologists",
"audiologists",
"hearing-instrument-fitters",
"midwives",
"sanitarians",
"laser-hair-professionals",
"laser-hair-facilities",
"podiatrists",
"driver-education-providers",
"driver-education-instructors",
"all-licenses"
],
"type": "string",
"description": "Which TDLR-licensed profession to extract license records for. Trade files (electricians, A/C, tow, cosmetology...) include mailing + business address and phone numbers; health-profession files include status and county.",
"default": "electricians-all"
},
"licenseTypes": {
"title": "License types / subtypes",
"uniqueItems": true,
"type": "array",
"description": "Optional. Only return licenses whose type or subtype matches, e.g. Master, Journeyman, ACR, or a TDLR subtype code like OP (cosmetology operator). Case-insensitive; type names match as substrings, subtype codes match exactly. Leave empty for all types in the selected profession.",
"default": [],
"items": {
"type": "string"
}
},
"counties": {
"title": "Counties",
"uniqueItems": true,
"type": "array",
"description": "Optional. Texas county names, e.g. Harris, Dallas, Travis, Bexar. Matches the licensee's county or the business county. Leave empty for statewide.",
"default": [],
"items": {
"type": "string"
}
},
"cities": {
"title": "Cities",
"uniqueItems": true,
"type": "array",
"description": "Optional. Exact city names, e.g. HOUSTON, AUSTIN. Case-insensitive; matches the mailing or business city. Leave empty for all cities.",
"default": [],
"items": {
"type": "string"
}
},
"zips": {
"title": "ZIP codes",
"uniqueItems": true,
"type": "array",
"description": "Optional. 5-digit ZIP codes, e.g. 78701. Matches the mailing or business ZIP. Leave empty for all ZIPs.",
"default": [],
"items": {
"type": "string"
}
},
"status": {
"title": "License status",
"enum": [
"current",
"any"
],
"type": "string",
"description": "TDLR's trade listings contain only currently licensed people and firms. Health-profession listings also include expired records — \"Currently licensed\" (default) filters those out; \"Any status\" keeps them.",
"default": "current"
},
"expiresBefore": {
"title": "License expires before",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string",
"description": "Optional. Only return licenses expiring before this date (format YYYY-MM-DD). Great for renewal/CE marketing lists."
},
"expiresAfter": {
"title": "License expires after",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string",
"description": "Optional. Only return licenses expiring after this date (format YYYY-MM-DD)."
},
"nameContains": {
"title": "Name contains",
"type": "string",
"description": "Optional. Case-insensitive substring match against the licensee name and business/DBA name."
},
"maxResults": {
"title": "Max results",
"minimum": 1,
"maximum": 2000000,
"type": "integer",
"description": "Maximum number of license records to return. You are only charged for records actually returned.",
"default": 500
}
}
},
"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
}
}
}
}
}
}
}
}
}
}