Aller au contenu principal
Piloterr
Retour à la bibliothèque

API TDLR License Search

Recherche les licences TDLR du Texas par nom, ville, comté ou ZIP. license_type, par exemple AIRREF, est nécessaire pour une recherche utile. 25 lignes par page.

Actif1 crédit = 1 requêteGET/v2/tdlr/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

AperçuLink to Aperçu

Recherche la liste des licences actives du TDLR au Texas. query est un nom de personne ou d'entreprise. license_type est le code du formulaire. Pour une recherche utile, envoyez un code tel que AIRREF (entrepreneurs en climatisation et réfrigération).

GET https://api.piloterr.com/v2/tdlr/search?query=SMITH&license_type=AIRREF

En-tête : x-api-key.

Chaque page contient 25 lignes. Il faut un nom, une ville, un comté ou un code postal. Un license_type vide interroge tous les types et sert rarement. Une URL de détail se passe à /v2/tdlr/license et renvoie 400 ici.

Les lignes de recherche laissent status, subtype, dba et original_issue_date vides. Ces champs sont sur l'endpoint licence.

ParamètresLink to Paramètres

query est facultatif si city, county ou postal_code est présent. Exemple : SMITH.

license_type est facultatif pour la requête et nécessaire pour une recherche utile. Exemple : AIRREF. ALL ou une valeur vide interroge tous les types. Un code qui n'a pas 2 à 12 lettres ou chiffres renvoie 400.

city est facultatif. Exemple : Austin.

county est facultatif. Exemple : TRAVIS.

postal_code est facultatif. Exemple : 78701.

page est facultatif, 1 par défaut. Exemple : 2.

Au moins un de query, city, county ou postal_code est obligatoire.

Champs de réponseLink to Champs de réponse

license_number est la licence publique, par exemple TACLA00000564E. detail_id est la clé de détail TDLR, par exemple AIRREF00000564. url est le lien SearchResultDetail. Passez detail_id ou url à l'endpoint licence.

name est le titulaire. business_name est l'entreprise quand la liste l'affiche entre parenthèses. expiration_date est la date de la liste, par exemple 12/24/2026. county est le comté. city, postal_code et phone sont remplis quand la liste les montre, et sont souvent null sur ce rapport.

license_type est le titre du jeu de résultats, par exemple Air Conditioning Contractors. license_type_code est le code tiré de detail_id, par exemple AIRREF.

status, subtype, dba et original_issue_date sont null sur une ligne de liste normale. notes est une liste vide. L'appel licence les remplit.

PaginationLink to Pagination

pagination.per_page vaut 25. pagination.page commence à 1. pagination.total_results est le nombre de "records retrieved". pagination.total_pages est ce nombre divisé par 25, arrondi au supérieur.

pagination.next est une URL tant que page est inférieur à total_pages. Sur la dernière page, next est null.

Pour SMITH et AIRREF, la liste observée avait 153 enregistrements et 7 pages. Les pages 1 et 2 avaient chacune 25 detail_id distincts, sans recouvrement. La page 7 avait 3 lignes et next était null.

Cas d'usageLink to Cas d'usage

  • Un entrepreneur général de Fort Bend vérifie les licences AIRREF au nom SMITH avant d'embaucher un sous-traitant.
  • Un guichet de permis liste les climaticiens du comté de Travis avec county=TRAVIS et license_type=AIRREF.
  • Un assureur parcourt chaque page de 25 lignes et repère les expiration_date à moins de 90 jours, puis ouvre url parce que la liste omet le statut.

Codes d'erreurLink to Codes d'erreur

  • 400 : ni nom, ni ville, ni comté, ni ZIP, code de type invalide, URL de détail, ou page inférieur à 1.
  • 404 : aucune ligne, ou page au-delà de la dernière page.
  • 401 : clé API absente.

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus