Contractor License Verification

Verify contractor licenses in California, Texas, and Florida in one API call. Catch unlicensed or lapsed contractors before they cost you a job, a fine, or a lawsuit.

原始信息汇总

Contractor License Verification API 数据集概述

数据集基本信息

• 数据集名称: Contractor License Verification
• 提供商: Gio Landicho
• 类别: Business Software
• 访问地址: https://rapidapi.com/giolandicho/api/contractor-license-verification
• 当前版本: v1

功能与用途

• 核心功能: 实时验证承包商执照，查询官方政府数据库。
• 主要用途:
  • 家庭服务平台（如Angi、Thumbtack风格）验证承包商资质。
  • 物业经理审查承包商。
  • 保险公司为承包商保单进行核保。
  • 房主在雇佣前进行尽职调查。

覆盖范围与数据源

• 支持州份:
  • 加利福尼亚州 — Contractors State License Board (CSLB)
  • 德克萨斯州 — Texas Department of Licensing and Regulation (TDLR)
  • 佛罗里达州 — Department of Business and Professional Regulation (DBPR)
• 数据来源: 官方政府门户网站。所有数据均为公共记录。

提供的数据信息

• 执照状态（活跃/非活跃/过期/暂停）
• 执照类型和到期日期
• 企业名称和所有者姓名
• 存档地址
• 纪律处分/投诉记录
• 20分钟响应缓存以提高速度

API端点

1. GET /verify

   • 描述: 通过执照号码查询单个执照。
   • 必需参数:
     • license_number (字符串): 承包商执照号码。
     • state (字符串): 州代码：CA、TX、FL。

2. GET /search

   • 描述: 通过企业或所有者名称搜索执照。
   • 必需参数:
     • name (字符串): 要搜索的企业或所有者名称。
     • state (字符串): 州代码：CA、TX、FL。
   • 可选参数:
     • limit (整数): 要返回的最大结果数（1–50），默认值为10。

3. GET /health

   • 描述: 返回每个州的爬虫运行状况。无需身份验证。

4. GET /states

   • 描述: 返回支持的州列表、其机构、执照类型和可用性状态。无需身份验证。

5. GET /status

   • 描述: 根据真实流量（非合成探测）返回每个州的管道运行状况。每个州报告operational（60分钟内成功抓取）、degraded（上次成功时间超过60分钟）或unknown（自上次部署以来无流量）。无需身份验证。

6. GET /probe

   • 描述: 实时端到端管道探测：对CA（CSLB）门户执行真实的HTTP请求，成功时返回{"status": "ok"}，失败时返回503。无需身份验证。在CA维护窗口（太平洋时间周日晚上8点至周一早上6点）期间返回503。

认证与定价

• 认证方式: 在每个请求的X-API-Key标头中传递API密钥。没有有效密钥的请求将返回403。
• 定价层级:
  • BASIC: 0美元/月，包含50次请求/月，仅限加州。
  • PRO: 49美元/月，包含1,000次请求/月，超出部分每次0.10美元，支持加州和德州。
  • ULTRA: 99美元/月，包含5,000次请求/月，超出部分每次0.08美元，支持加州、德州和佛罗里达州。
  • MEGA: 249美元/月，包含25,000次请求/月，超出部分每次0.02美元，支持所有州。

性能与缓存

• 缓存命中 (cache_hit: true): <100毫秒。
• 缓存未命中 (实时抓取): 3–10秒 — 数据从政府门户实时获取。
• 缓存TTL: /verify为20分钟，/search为15分钟。
• 加利福尼亚维护窗口: 太平洋时间周日晚上8点至周一早上6点；在此期间，针对加州的请求将返回503。

错误代码

• 403: 缺少或无效的API密钥，或您的层级不支持该州。
• 404: 在请求的州中未找到执照号码。
• 422: 无效的请求参数。
• 429: 超出速率限制。
• 501: 尚未支持的州（例如纽约）。
• 503: 州爬虫不可用。

所有错误均返回{"detail": "explanation string"}。