Texas TDLR License Scraper

Extract Texas TDLR license and registration records for licensed provider research, supplier screening and register monitoring. Texas TDLR License Scraper collects public information into one complete dataset table, ready to export as Excel, CSV or JSON.

Use search filters or individual public record links, set how many results you need and start the Actor. Search finds matching records; Details retrieves the available information for records you already know.

At a glance	Details
📥 Input	Search filters or individual public record links
📋 Collection modes	Search licences; Get licence details
📤 Output	One row per record, or a failed row for an unsuccessful input
📄 Pagination	Automatic, up to maxResults while more records are available
🔐 Website login	Not required
💾 Export	One dataset view with all fields; Excel, CSV and JSON

What the Texas TDLR scraper collects 📋

Mode	What you receive
Search licences	Matching license and registration records and the fields published in the search results.
Get licence details	Available public information for each supplied record. The full output example below shows its actual fields.

The field table and complete examples below show the information this Actor returns. Optional values depend on what the source publishes for the selected record.

Coverage for this Actor:

• Covers the public TDLR licence categories and Texas cities offered by the register. Availability of business names, addresses and telephone numbers varies by licence.

How to scrape Texas TDLR 🚀

1. Choose Search licences or Get licence details.
2. Complete the search filters or individual public record links.
3. Set Maximum results. The minimum is 1.
4. Start the Actor and review the saved dataset.
5. Export the results or connect them to your workflow.

Search licences — input example

{
  "mode": "search",
  "licenceType": "Air Conditioning Contractors",
  "city": "Austin",
  "maxResults": 75
}

Get licence details — input example

{
  "mode": "details",
  "recordUrls": [
    "https://www.tdlr.texas.gov/LicenseSearch/SearchResultDetail.asp?1=AIRREF00000171"
  ],
  "maxResults": 1
}

maxResults limits all saved rows for each search or supplied record, including a failed row. It does not guarantee that the source has that many matching records. A detail lookup normally returns one record, although sources with multiple revisions or establishments can return more.

Texas TDLR data fields and complete output 📦

Each result stays in one row. Every returned field appears in the same dataset view, including list fields and additional published facts. Fields unavailable for a particular record remain empty.

Field	Included data
result_type	Selected collection mode.
input	Submitted search settings, record link or record number.
status	Collection status for this record.
error_code	Failure category for an unsuccessful input.
error_message	Readable explanation for an unsuccessful input.
record_id	Stable identifier assigned by the source, or its persistent profile slug.
name	Published name of the company, product, institution or licence holder.
url	Public page for this record; absent when no public profile link is supplied.
licence_number	Public licence or certificate number.
expiry_date	Published expiry date or renewal-process wording.
county	County recorded by the source.
additional_fields.name	Names of additional published fields, when present.
additional_fields.value	Their corresponding values in the same order.
business_name	Registered trading name or DBA shown on the record.
licence_status	Status exactly as published by the licensing authority.
licence_type	Published licence or certificate type.
original_issue_date	Original licence issue date.
holder_information	Public holder and business information shown on the licence record.

The complete result below is included for every mode. Text and lists are not shortened. These are examples from validation runs; the source can change.

Search licences — complete JSON result

{
  "result_type": "search",
  "input": "{\"city\": \"Austin\", \"licenceNumber\": \"\", \"licenceType\": \"Air Conditioning Contractors\", \"name\": \"\"}",
  "status": "success",
  "record_id": "AIRREF00000171",
  "name": "MUNDAHL, EUGENE DARRELL (AIR PRO INC)",
  "url": "https://www.tdlr.texas.gov/LicenseSearch/SearchResultDetail.asp?1=AIRREF00000171",
  "licence_number": "TACLA00000171C",
  "expiry_date": "05/04/2027",
  "county": "TRAVIS",
  "additional_fields.name": [],
  "additional_fields.value": []
}

Get licence details — complete JSON result

{
  "result_type": "details",
  "input": "https://www.tdlr.texas.gov/LicenseSearch/SearchResultDetail.asp?1=AIRREF00000171",
  "status": "success",
  "record_id": "AIRREF00000171",
  "name": "MUNDAHL, EUGENE DARRELL",
  "url": "https://www.tdlr.texas.gov/LicenseSearch/SearchResultDetail.asp?1=AIRREF00000171",
  "business_name": "AIR PRO INC",
  "licence_number": "TACLA00000171C",
  "licence_status": "Active",
  "licence_type": "AC",
  "county": "TRAVIS",
  "expiry_date": "05/04/2027",
  "original_issue_date": "05/04/1984",
  "holder_information": "MUNDAHL, EUGENE DARRELL AIR PRO INC County: TRAVIS DBA: AIR PRO INC",
  "additional_fields.name": [],
  "additional_fields.value": []
}

Input settings ⚙️

Setting	What to enter
What to collect (mode)	Choose the information you need.
Maximum results per search or link (maxResults)	Collect up to this many saved results for each search or record link. Minimum: 1.
Licence type (licenceType)	Published licence type, such as Air Conditioning Contractors or Electricians.
Texas city (city)	Texas city.
Licensee or business name (name)	Licensee or business name.
Licence number (licenceNumber)	Licence number.
Licence links (recordUrls)	Paste one individual public record link per line. Use this field in Details mode.

Texas TDLR scraping use cases 🎯

Find registered providers

Search the supported register using names, locations, license categories or other available fields.

Review published registration details

Collect available license numbers, organization names, status and scope before conducting your own review.

Monitor register changes

Compare exports by stable record ID to identify changes in published registration details. A record alone is not an endorsement or a substitute for an official certificate.

Pricing and saved-result behavior 💰

See the Actor’s Pricing tab for the current rate. Under dataset-item pricing:

• Each saved record is one result. Lists and additional details attached to it do not create extra rows.
• A saved failed row is also one billable dataset item. This includes invalid inputs, unavailable records, empty searches and exhausted retries.
• At most one failed row is saved per input. Retry attempts do not create additional dataset rows.
• maxResults caps all saved rows for the input. Duplicate copies of the same input are processed once.

Texas TDLR scraper API and integrations 🔌

Replace $ACTOR_ID with the ID shown in the Actor’s API tab and $APIFY_TOKEN with your Apify token.

curl -X POST "https://api.apify.com/v2/acts/$ACTOR_ID/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"search","licenceType":"Air Conditioning Contractors","city":"Austin","maxResults":75}'

Use Apify schedules for recurring collection, webhooks for completion notifications, and integrations for Google Sheets, Make, Zapier, cloud storage or your own application.

Reliability and public-data limits ⚠️

Temporary request failures are retried up to five total attempts. Invalid record inputs save a failed row without a website request. Confirmed missing records are not retried unnecessarily. If a later request fails, records already saved remain in the dataset. Normal pagination completion does not add a failed row. Collection stops after two consecutive pages return no new records. Configuration, data-saving or request-scheduling failures stop the run.

Texas TDLR controls the available records and fields. Search records can contain less information than a full public card. The Actor preserves published values and does not fill missing facts with estimates.

Frequently asked questions ❓

Do I need a Texas TDLR account?

No. This Actor collects the supported public information without your website login.

Which search filters can I use?

The input form supports licence type, texas city, licensee or business name, licence number. Only the displayed filters are supported.

How many records can I collect?

Set maxResults to the maximum saved rows you want for each input. The minimum is 1. Collection can finish earlier when the source runs out of results or stops returning new records.

Why are some fields empty?

The source may not publish a value for that record or mode. Optional information remains empty.

Can I export all the fields?

Yes. All returned fields are included in one dataset view. Nested lists remain attached to their parent record.

Support 🛟

For a reproducible issue, share the run ID, selected mode and a safe public example through the Actor’s support channel. Keep tokens, passwords and proxy credentials private.