TDLR License Scraper — Texas Contractor License Lookup avatar

TDLR License Scraper — Texas Contractor License Lookup

Pricing

from $20.00 / 1,000 tdlr license records

Go to Apify Store
TDLR License Scraper — Texas Contractor License Lookup

TDLR License Scraper — Texas Contractor License Lookup

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.

Pricing

from $20.00 / 1,000 tdlr license records

Rating

0.0

(0)

Developer

Muhammad Afzal

Muhammad Afzal

Maintained by Community

Actor stats

0

Bookmarked

1

Total users

1

Monthly active users

16 days ago

Last modified

Features

Limited permissions

Share

TDLR License Scraper searches the Texas Department of Licensing and Regulation (TDLR) license database and returns one record per license: license number, class and description, holder or business name, address, county, phone and email where TDLR prints them, status, issue and expiration dates, sponsor, bond, insurance, discipline and violations. It is built for contractor lead generation, subcontractor license verification and insurance screening, and it costs USD 25.00 per 1,000 license records on the FREE tier (USD 20.00 per 1,000 on GOLD).

What data does the TDLR license scraper return?

Each dataset row is one license, read from its TDLR detail page:

FieldWhat it contains
licenseNumberTDLR license number
licenseTypeThe license program you searched, for example Electricians
licenseClass, licenseDescriptionClass code and its description, for example RAIC / Residential Appliance Installation Contractor
businessNameHolder or business name as printed on the first line of the name block
address, city, state, zipCode, countyAddress parts from the detail page
phone, emailContact details, published by TDLR only for some programs; otherwise null
statusLicense status from the page, or Expired when no status is printed and the expiration date has passed
issueDate, expirationDate, renewalDateDates as YYYY-MM-DD
bondAmount, insuranceAmountPublished for programs that require them; otherwise null
sponsor, sponsorLicenseNumber, sponsorExpirationSponsoring licensee, for example the master electrician behind a contractor license
discipline, violationsText from the page when it has a Discipline or Violations section; otherwise null
contactNameThe licensee's name for licenses held by an individual (printed as LAST, FIRST); null for business licenses, because TDLR prints no contact person for them
detailUrl, source_url, scraped_atTDLR detail page and collection time

How do I look up Texas electricians, A/C contractors or other TDLR licenses in bulk?

Pick a License Program Type, add a location filter, set Max Results and run. The Actor submits the TDLR license search, opens each license's detail page and saves one record per license.

Filters that are applied to the TDLR search today:

InputExampleNotes
licenseTypeElectricians, Air Conditioning Contractors, Elevator Contractors, Cosmetologists106 TDLR programs; prefilled Electricians
licenseNumber80019One specific license
ownerNameSMITHFills TDLR's name field (LAST, FIRST, starts-with match)
businessNameACME ELECTRICFills the same TDLR name field for a business; use either this or ownerName
cityAustinSpelled as TDLR spells it
countyHarris255 options, including Out Of State
zipCode787015-digit ZIP
technicianTypeCertifiedRegistered or Certified; applies to the A/C Technicians program only
maxResults100Default 50

Electricians in Austin:

{
"licenseType": "Electricians",
"city": "Austin",
"maxResults": 50
}

Air conditioning contractors in Harris County:

{
"licenseType": "Air Conditioning Contractors",
"county": "Harris",
"maxResults": 100
}

Can I verify a single TDLR license number?

Yes. Set licenseType to the program and licenseNumber to the number, and set maxResults to 1. The record shows status, expiration date, sponsor, and bond, insurance and discipline text where TDLR publishes them, with detailUrl linking to the official page for your file.

When should I use TDLR License Scraper, and when not?

Use it when you need Texas license records for a trade or occupation, for example a list of licensed electricians in a county for outreach, or a status and expiration check across your subcontractors.

Use another Actor when:

How do I run it from code?

JavaScript with apify-client:

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('muhammadafzal/tdlr-texas-scraper').call({
licenseType: 'Electricians',
county: 'Travis',
maxResults: 100,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const item of items) console.log(item.licenseNumber, item.businessName, item.status, item.expirationDate);

Python with apify-client:

import os
from apify_client import ApifyClient
client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("muhammadafzal/tdlr-texas-scraper").call(run_input={
"licenseType": "Air Conditioning Contractors",
"zipCode": "77002",
"maxResults": 25,
})
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item["licenseNumber"], item.get("phone"), item.get("expirationDate"))

Use it from an AI assistant

TDLR License Scraper works from Claude, ChatGPT, Cursor or any MCP client through Apify's MCP server. Add the single-tool URL https://mcp.apify.com/?tools=muhammadafzal/tdlr-texas-scraper to your client and ask, for example: "Find 25 licensed electricians in Austin, Texas from TDLR with their license status and expiration dates." Each record is charged at the prices below, so include a result limit in your request.

What does the output look like?

Two shortened records (sample values in the shape of a 2026-09-24 cloud run):

[
{
"licenseNumber": "10001",
"licenseType": "Electricians",
"licenseClass": "RAIC",
"licenseDescription": "Residential Appliance Installation Contractor",
"businessName": "EXAMPLE APPLIANCE INSTALLATION, INC",
"contactName": null,
"address": "100 MAIN ST AUSTIN TX 78757",
"city": "AUSTIN",
"state": "TX",
"zipCode": "78757",
"county": "TRAVIS",
"phone": "(512) 555-0100",
"email": null,
"status": "Active",
"issueDate": "2008-02-29",
"expirationDate": "2027-02-28",
"sponsorLicenseNumber": "123456",
"sponsorExpiration": "2027-07-12",
"discipline": null,
"violations": null,
"detailUrl": "https://www.tdlr.texas.gov/LicenseSearch/SearchResultDetail.asp?1=...",
"scraped_at": "2026-09-24T17:10:25.767Z"
},
{
"licenseNumber": "12345",
"licenseType": "Electricians",
"licenseClass": "ME",
"licenseDescription": "Master Electrician",
"businessName": "DOE, JANE A",
"contactName": "DOE, JANE A",
"city": "AUSTIN",
"county": "TRAVIS",
"phone": null,
"status": "Active",
"expirationDate": "2027-05-31",
"bondAmount": null,
"insuranceAmount": null
}
]

How much does a TDLR license lookup cost?

The Actor uses pay-per-event pricing, and platform usage is included in the event prices.

EventFREEBRONZESILVERGOLDPLATINUM / DIAMOND
TDLR license record (one dataset row)USD 0.025001USD 0.024375USD 0.02375USD 0.02USD 0.02
Actor start (per started GB of allocated memory)USD 0.006251USD 0.006094USD 0.005938USD 0.005USD 0.005

Worked totals on the FREE tier at the default 512 MB memory (one start event, USD 0.006251):

  • 5-record test: 5 × USD 0.025001 + USD 0.006251 = USD 0.131256
  • 50 records: 50 × USD 0.025001 + USD 0.006251 = USD 1.256301

Each record is saved before it is charged, and the run stops when your maximum cost per run is reached. A search with no matching licenses charges only the start events. Set a maximum cost per run in Apify Console to cap spending.

What are the limits?

  • All result pages. The Actor follows TDLR's result pages (25 licenses each) until maxResults. A very large pull stops cleanly shortly before the run timeout and keeps the records already saved; raise the timeout or split by city or ZIP for big lists.
  • Contact fields vary. Phone, email, bond and insurance appear only for programs where TDLR prints them.
  • Discipline text. discipline and violations are null when the page has no matching section; null is not proof of a clean record, so open detailUrl before relying on it.
  • Speed. A 1-record run took about 11 seconds in the cloud on 2026-09-24; detail pages load four at a time.
  • Empty input. A run with no filter searches the Electricians program statewide.
  • Data access is handled by the Actor; no login or setup is needed.

FAQ

Is TDLR license lookup free?

TDLR's own search is free for manual lookups. This Actor charges per saved license record at the prices above and returns structured data in bulk.

Which license types include phone and email?

It depends on the program; TDLR prints contact details for some programs and not others. When TDLR does not print them, phone and email are null.

Can I search by business name?

Yes. Put the start of the name in businessName; it fills TDLR's name field with a starts-with match. Use ownerName instead for an individual (LAST, FIRST).

How many records can one run return?

All matching licenses across TDLR's result pages, up to your maxResults and the run timeout. Split very large areas by city, county or ZIP.

Does it show disciplinary actions?

It returns the discipline and violations text when the detail page has those sections; otherwise both are null.

How do I check an expiring license?

Filter by license number or area, then sort the dataset by expirationDate.

TDLR License Scraper reads public license records from the Texas Department of Licensing and Regulation search at tdlr.texas.gov/LicenseSearch. It does not log in or bypass access controls. License holders' names, addresses and phone numbers can be personal data: use them lawfully, follow CAN-SPAM, TCPA and Do Not Call rules for outreach, and verify licenses on the official site before hiring. This tool is not affiliated with TDLR, and this is not legal advice.

Last verified: 2026-10-27