TDLR License Scraper — Texas Contractor License Lookup
Pricing
from $20.00 / 1,000 tdlr license records
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
Maintained by CommunityActor stats
0
Bookmarked
1
Total users
1
Monthly active users
16 days ago
Last modified
Categories
Features
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:
| Field | What it contains |
|---|---|
licenseNumber | TDLR license number |
licenseType | The license program you searched, for example Electricians |
licenseClass, licenseDescription | Class code and its description, for example RAIC / Residential Appliance Installation Contractor |
businessName | Holder or business name as printed on the first line of the name block |
address, city, state, zipCode, county | Address parts from the detail page |
phone, email | Contact details, published by TDLR only for some programs; otherwise null |
status | License status from the page, or Expired when no status is printed and the expiration date has passed |
issueDate, expirationDate, renewalDate | Dates as YYYY-MM-DD |
bondAmount, insuranceAmount | Published for programs that require them; otherwise null |
sponsor, sponsorLicenseNumber, sponsorExpiration | Sponsoring licensee, for example the master electrician behind a contractor license |
discipline, violations | Text from the page when it has a Discipline or Violations section; otherwise null |
contactName | The 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_at | TDLR 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:
| Input | Example | Notes |
|---|---|---|
licenseType | Electricians, Air Conditioning Contractors, Elevator Contractors, Cosmetologists | 106 TDLR programs; prefilled Electricians |
licenseNumber | 80019 | One specific license |
ownerName | SMITH | Fills TDLR's name field (LAST, FIRST, starts-with match) |
businessName | ACME ELECTRIC | Fills the same TDLR name field for a business; use either this or ownerName |
city | Austin | Spelled as TDLR spells it |
county | Harris | 255 options, including Out Of State |
zipCode | 78701 | 5-digit ZIP |
technicianType | Certified | Registered or Certified; applies to the A/C Technicians program only |
maxResults | 100 | Default 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:
- You want contractor leads with website emails and services rather than license records: Electrician Leads Scraper or HVAC Leads Scraper.
- You need licensed contractors across several states: Contractor License Leads.
- Your contractors are in Oregon: Oregon CCB Contractor License Scraper. For California use California CSLB Scraper; for Florida use Florida Contractor Directory & Leads Scraper.
- You need a company's registration details rather than a license: Sunbiz Scraper for Florida, or New York Business Entity Search Scraper.
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 osfrom apify_client import ApifyClientclient = 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.
| Event | FREE | BRONZE | SILVER | GOLD | PLATINUM / DIAMOND |
|---|---|---|---|---|---|
| TDLR license record (one dataset row) | USD 0.025001 | USD 0.024375 | USD 0.02375 | USD 0.02 | USD 0.02 |
| Actor start (per started GB of allocated memory) | USD 0.006251 | USD 0.006094 | USD 0.005938 | USD 0.005 | USD 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.
disciplineandviolationsarenullwhen the page has no matching section;nullis not proof of a clean record, so opendetailUrlbefore 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
Electriciansprogram 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.
Related Actors
- Oregon CCB Contractor License Scraper: active Oregon contractor licenses with bond and insurance
- Sunbiz Scraper and New York Business Entity Search Scraper: company registry records
- KRS Financial Statements Scraper: Polish company filings
- Contractor License Leads and Electrician Leads Scraper: contractor prospecting
Legal and compliance
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