{
  "openapi": "3.0.1",
  "info": {
    "title": "TDLR License Scraper — Texas Contractor License Lookup",
    "description": "Look up Texas TDLR licenses by program, city, county or ZIP: license class, status, expiration, sponsor, phone and bond where published. USD 25 per 1,000.",
    "version": "1.0",
    "x-build-id": "hKYazW7MTkS4aUQPB"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/muhammadafzal~tdlr-texas-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-muhammadafzal-tdlr-texas-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/muhammadafzal~tdlr-texas-scraper/runs": {
      "post": {
        "operationId": "runs-sync-muhammadafzal-tdlr-texas-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/muhammadafzal~tdlr-texas-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-muhammadafzal-tdlr-texas-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": {
          "licenseType": {
            "title": "License Program Type",
            "enum": [
              "A/C Technicians",
              "ACR Certification Training Program",
              "Air Conditioning Contractors",
              "Associate Auctioneers",
              "Athletic Trainers",
              "ATV Instructor",
              "Auctioneers",
              "Audiologist",
              "Audiologist - Assistant",
              "Barber Schools",
              "Barber Shops",
              "Barber Shops - Dual",
              "Barber Shops - Mini",
              "Barber Shops - Mini Dual",
              "Barber Shops - Mobile",
              "Barbers",
              "Behavior Analysts",
              "Behavior Analysts Assistants",
              "Boiler Authorized Inspection Agencies",
              "Boiler Inspectors",
              "Code Enforcement Officer",
              "Combative Sports Amateur Promotors",
              "Combative Sports Contestants",
              "Combative Sports Event Coordinators",
              "Combative Sports Judges",
              "Combative Sports Managers",
              "Combative Sports Matchmakers",
              "Combative Sports Promoters",
              "Combative Sports Referees",
              "Combative Sports Seconds",
              "Continuing Education Providers",
              "Cosmetologists",
              "Cosmetology Salons",
              "Cosmetology Salons - Dual",
              "Cosmetology Salons - Mini",
              "Cosmetology Salons - Mini Dual",
              "Cosmetology Salons - Mobile",
              "Cosmetology Schools",
              "Court-Ordered Program Instructors",
              "Court-Ordered Programs",
              "Dietitians",
              "Driver Education and Safety",
              "Driver Education Instructor",
              "Driver Education Provider – Branch",
              "Driver Education Provider – Primary",
              "Driving Safety Provider",
              "Dyslexia Practitioner",
              "Dyslexia Therapist",
              "Electric Vehicle Charging Stations",
              "Electrician Apprenticeship Programs",
              "Electricians",
              "Elevator Contractors",
              "Elevator Inspectors",
              "Elevator Responsible Party",
              "Hearing Instrument CE Provider",
              "Hearing Instrument FD Training permit",
              "Hearing Instrument Fitter / Dispenser",
              "Identity Recovery Service Contract",
              "Laser Hair Removal Facility",
              "Laser Hair Removal Professions",
              "Laser Hair Removal Training Providers",
              "Licensed Breeders",
              "Massage Therapist",
              "Massage Therapist Instructor",
              "Massage Therapy Establishment",
              "Massage Therapy School",
              "Midwife",
              "Midwife Course provider",
              "Mobile Dual Shop",
              "Mold Analysis Laboratory",
              "Mold Assessment Company",
              "Mold Assessment Consultant",
              "Mold Assessment Technician",
              "Mold Remediation Company",
              "Mold Remediation Contractor",
              "Mold Remediation Worker",
              "Mold Training Provider",
              "Motor Fuel Metering & Quality Device",
              "Motor Fuel Metering & Quality Distrib/Wholesaler",
              "Motor Fuel Metering & Quality Service Technician",
              "Motor Fuel Metering & Quality Supplier",
              "Motor Fuel Metering and Quality Service Company",
              "Motorcycle Instructor",
              "Podiatrists",
              "Professional Employer Organization",
              "Property Tax Consultants",
              "Property Tax Professional Core Education Providers",
              "Property Tax Professionals",
              "Prosthetist/Orthotist – Accredited Facility",
              "Prosthetist/Orthotist - Licensed",
              "Prosthetist/Orthotist – Licensed Assistant",
              "Prosthetist/Orthotist - Technician",
              "Registered Accessibility Specialists",
              "Sanitarian",
              "Service Contract Providers",
              "Speech Language Pathologist",
              "Speech Language Pathologist – Assistant",
              "Tow Companies",
              "Tow Truck Operators",
              "Transportation Network Company",
              "Used Auto Parts Recycler",
              "Vehicle Storage Facilities",
              "Vehicle Storage Facility Employees",
              "Water Well Drillers, Pump Installers",
              "Water Well/Pump Installers Apprentices",
              "Weather Modification"
            ],
            "type": "string",
            "description": "The TDLR license program to search. Use this when the user asks for a specific trade or occupation — e.g. 'Air Conditioning Contractors', 'Electricians', 'Elevator Contractors', 'Cosmetologists', 'Massage Therapist'. Do NOT combine with licenseNumber unless you want to narrow further. Electricians and Elevator Contractors license types are the ones that publish contact info (address, phone, email)."
          },
          "licenseNumber": {
            "title": "License Number",
            "type": "string",
            "description": "A specific TDLR license number to look up (e.g. '80019'). Use this for single-license verification. Leave empty when browsing all licenses of a given program type."
          },
          "businessName": {
            "title": "Business Name",
            "type": "string",
            "description": "Business name to search, for example 'ACME ELECTRIC'. It fills TDLR's single name field with a 'Starts with' match. Use either this or Owner / Individual Name, not both. Leave empty to match all names."
          },
          "ownerName": {
            "title": "Owner / Individual Name",
            "type": "string",
            "description": "License holder (individual/owner) name to search, written 'LAST, FIRST' or just the last name (e.g. 'SMITH'). TDLR matches names that start with this text. Use either this or Business Name, not both. Leave empty to match all owners."
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "Texas city name filter (e.g. 'Austin', 'Houston', 'Dallas'). Type the exact city spelling as TDLR uses it; not a dropdown — any city string works. Leave empty for statewide results."
          },
          "county": {
            "title": "County",
            "enum": [
              "Anderson",
              "Andrews",
              "Angelina",
              "Aransas",
              "Archer",
              "Armstrong",
              "Atascosa",
              "Austin",
              "Bailey",
              "Bandera",
              "Bastrop",
              "Baylor",
              "Bee",
              "Bell",
              "Bexar",
              "Blanco",
              "Borden",
              "Bosque",
              "Bowie",
              "Brazoria",
              "Brazos",
              "Brewster",
              "Briscoe",
              "Brooks",
              "Brown",
              "Burleson",
              "Burnet",
              "Caldwell",
              "Calhoun",
              "Callahan",
              "Cameron",
              "Camp",
              "Carson",
              "Cass",
              "Castro",
              "Chambers",
              "Cherokee",
              "Childress",
              "Clay",
              "Cochran",
              "Coke",
              "Coleman",
              "Collin",
              "Collingsworth",
              "Colorado",
              "Comal",
              "Comanche",
              "Concho",
              "Cooke",
              "Coryell",
              "Cottle",
              "Crane",
              "Crockett",
              "Crosby",
              "Culberson",
              "Dallam",
              "Dallas",
              "Dawson",
              "Deaf Smith",
              "Delta",
              "Denton",
              "Dewitt",
              "Dickens",
              "Dimmit",
              "Donley",
              "Duval",
              "Eastland",
              "Ector",
              "Edwards",
              "Ellis",
              "El Paso",
              "Erath",
              "Falls",
              "Fannin",
              "Fayette",
              "Fisher",
              "Floyd",
              "Foard",
              "Fort Bend",
              "Franklin",
              "Freestone",
              "Frio",
              "Gaines",
              "Galveston",
              "Garza",
              "Gillespie",
              "Glasscock",
              "Goliad",
              "Gonzales",
              "Gray",
              "Grayson",
              "Gregg",
              "Grimes",
              "Guadalupe",
              "Hale",
              "Hall",
              "Hamilton",
              "Hansford",
              "Hardeman",
              "Hardin",
              "Harris",
              "Harrison",
              "Hartley",
              "Haskell",
              "Hays",
              "Hemphill",
              "Henderson",
              "Hidalgo",
              "Hill",
              "Hockley",
              "Hood",
              "Hopkins",
              "Houston",
              "Howard",
              "Hudspeth",
              "Hunt",
              "Hutchinson",
              "Irion",
              "Jack",
              "Jackson",
              "Jasper",
              "Jeff Davis",
              "Jefferson",
              "Jim Hogg",
              "Jim Wells",
              "Johnson",
              "Jones",
              "Karnes",
              "Kaufman",
              "Kendall",
              "Kenedy",
              "Kent",
              "Kerr",
              "Kimble",
              "King",
              "Kinney",
              "Kleberg",
              "Knox",
              "Lamar",
              "Lamb",
              "Lampasas",
              "La Salle",
              "Lavaca",
              "Lee",
              "Leon",
              "Liberty",
              "Limestone",
              "Lipscomb",
              "Live Oak",
              "Llano",
              "Loving",
              "Lubbock",
              "Lynn",
              "Madison",
              "Marion",
              "Martin",
              "Mason",
              "Matagorda",
              "Maverick",
              "Medina",
              "Menard",
              "Midland",
              "Milam",
              "Mills",
              "Mitchell",
              "Montague",
              "Montgomery",
              "Moore",
              "Morris",
              "Motley",
              "McCulloch",
              "McLennan",
              "McMullen",
              "Nacogdoches",
              "Navarro",
              "Newton",
              "Nolan",
              "Nueces",
              "Ochiltree",
              "Oldham",
              "Orange",
              "Palo Pinto",
              "Panola",
              "Parker",
              "Parmer",
              "Pecos",
              "Polk",
              "Potter",
              "Presidio",
              "Rains",
              "Randall",
              "Reagan",
              "Real",
              "Red River",
              "Reeves",
              "Refugio",
              "Roberts",
              "Robertson",
              "Rockwall",
              "Runnels",
              "Rusk",
              "Sabine",
              "San Augustine",
              "San Jacinto",
              "San Patricio",
              "San Saba",
              "Schleicher",
              "Scurry",
              "Shackelford",
              "Shelby",
              "Sherman",
              "Smith",
              "Somervell",
              "Starr",
              "Stephens",
              "Sterling",
              "Stonewall",
              "Sutton",
              "Swisher",
              "Tarrant",
              "Taylor",
              "Terrell",
              "Terry",
              "Throckmorton",
              "Titus",
              "Tom Green",
              "Travis",
              "Trinity",
              "Tyler",
              "Upshur",
              "Upton",
              "Uvalde",
              "Val Verde",
              "Van Zandt",
              "Victoria",
              "Walker",
              "Waller",
              "Ward",
              "Washington",
              "Webb",
              "Wharton",
              "Wheeler",
              "Wichita",
              "Wilbarger",
              "Willacy",
              "Williamson",
              "Wilson",
              "Winkler",
              "Wise",
              "Wood",
              "Yoakum",
              "Young",
              "Zapata",
              "Zavala",
              "Out Of State"
            ],
            "type": "string",
            "description": "Texas county filter (e.g. 'Travis', 'Harris', 'Dallas'). Select from the official TDLR county list. 'Out Of State' matches licensees located outside Texas. Leave empty for statewide results."
          },
          "zipCode": {
            "title": "ZIP Code",
            "type": "string",
            "description": "Texas ZIP code filter (e.g. '78701'). Use a 5-digit ZIP for the most precise geographic filter. Leave empty for statewide results."
          },
          "technicianType": {
            "title": "Technician Type",
            "enum": [
              "All",
              "Registered",
              "Certified"
            ],
            "type": "string",
            "description": "Registered or Certified filter for the 'A/C Technicians' license program (TDLR's technician type). It applies to that program only and is ignored for other programs. Leave it at 'All' for every technician.",
            "default": "All"
          },
          "maxResults": {
            "title": "Max Results",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Maximum number of license records to return. The Actor follows TDLR's result pages (25 licenses per page) until this limit. Use a small value (5) to verify fields quickly, then scale up for lead lists. Very large pulls stop cleanly before the run timeout with the records saved so far.",
            "default": 50
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}