{ "openapi": "3.0.1", "info": { "title": "US Contractor License Scraper & Lookup - 20 States", "description": "Contractor license data from 20 US state boards: Texas, Florida, California, Virginia, Arizona and 15 more. Verify names or license numbers in bulk, or export a whole state and trade: roofing, electrical, plumbing, HVAC, pools. Status, expiry date, address, phone and email. Official registries.", "version": "1.0", "x-build-id": "QYPMqMfTnaZO6v40X" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/wellbuilt_zythem~us-contractor-license-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-wellbuilt_zythem-us-contractor-license-lookup", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/wellbuilt_zythem~us-contractor-license-lookup/runs": { "post": { "operationId": "runs-sync-wellbuilt_zythem-us-contractor-license-lookup", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/wellbuilt_zythem~us-contractor-license-lookup/run-sync": { "post": { "operationId": "run-sync-wellbuilt_zythem-us-contractor-license-lookup", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "lookup", "export" ], "type": "string", "description": "Lookup checks a list of names or licence numbers across states. Export pulls every licence of a state and trade.", "default": "lookup" }, "queries": { "title": "Names or licence numbers to look up", "type": "array", "description": "One per line. A licence number matches exactly; a name matches any licensee or business containing it. Paste as many as you like.", "items": { "type": "string" } }, "states": { "title": "States", "type": "array", "description": "Leave empty for every state covered. Currently 20: TX, WA, OR, NY, FL, LA, AL, CA, MN, NV, OH, TN, NC, MI, AZ, AR, OK, CT, DE and VA, each read from its official licensing board.", "items": { "type": "string", "enum": [ "TX", "WA", "OR", "NY", "FL", "LA", "AL", "CA", "MN", "NV", "OH", "TN", "NC", "MI", "AZ", "AR", "OK", "CT", "DE", "VA" ], "enumTitles": [ "Texas", "Washington", "Oregon", "New York", "Florida", "Louisiana", "Alabama", "California", "Minnesota", "Nevada", "Ohio", "Tennessee", "North Carolina", "Michigan", "Arizona", "Arkansas", "Oklahoma", "Connecticut", "Delaware", "Virginia" ] }, "default": [] }, "trades": { "title": "Trades", "type": "array", "description": "Leave empty for every trade. A trade is skipped in states that do not license it.", "items": { "type": "string", "enum": [ "construction-contractor", "electrical-contractor", "plumbing-contractor", "elevator-contractor", "electrical-sign-contractor", "appliance-installation", "water-well-driller", "mold-remediation-contractor", "mold-remediation-company", "mold-assessment-company", "specialty-contractor", "lead-paint-renovation-contractor", "home-inspector", "roofing-contractor", "hvac-contractor", "pool-spa-contractor", "alarm-system-contractor", "asbestos-contractor", "home-improvement-contractor", "hydronics-contractor", "refrigeration-contractor", "fire-sprinkler-contractor", "fuel-piping-contractor", "painting-contractor", "concrete-contractor", "landscaping-contractor", "excavation-contractor", "carpentry-contractor", "training-agency", "heavy-civil-contractor", "siding-gutters-contractor", "solar-contractor", "construction-transport-contractor", "construction-management", "engineering", "architecture", "landscape-architecture", "septic-system-contractor", "gas-fitting-contractor", "accessibility-contractor", "backflow-prevention-worker", "building-energy-analyst" ], "enumTitles": [ "Construction contractor (WA, OR, FL, LA, AL, CA, MN, NV, TN, NC, MI, AZ, AR, CT, DE, VA)", "Electrical contractor (TX, WA, FL, LA, AL, CA, MN, NV, OH, TN, NC, MI, AZ, AR, CT, DE, VA)", "Plumbing contractor (WA, FL, LA, AL, CA, MN, NV, OH, TN, NC, MI, AZ, AR, CT, DE, VA)", "Elevator contractor (TX, WA, NY, FL, CA, MN, NV, NC, AZ, AR, CT, DE, VA)", "Electrical sign contractor (TX)", "Appliance installation contractor (TX)", "Water well driller (TX, AR, DE, VA)", "Mold remediation contractor (TX, NY, FL, LA)", "Mold remediation company (TX)", "Mold assessment company / assessor (TX, FL)", "Specialty contractor (OR, FL, CA, NV, NC, AZ, CT, VA)", "Lead-based paint renovation contractor (OR, AR, VA)", "Home inspector (OR, FL)", "Roofing contractor (FL, LA, AL, CA, MN, NV, TN, NC, MI, AZ, AR, OK, CT, DE, VA)", "Air conditioning and mechanical contractor (FL, LA, AL, CA, NV, OH, TN, NC, MI, AZ, AR, CT, DE, VA)", "Pool and spa contractor (FL, LA, CA, NC, AZ, AR, VA)", "Alarm system contractor (FL, TN, NC, AZ, AR, DE, VA)", "Asbestos contractor (FL, LA, AL, CA, NC, AR, DE, VA)", "Home improvement contractor (LA, TN, MI, AZ, AR, CT, VA)", "Hydronics contractor (OH)", "Refrigeration contractor (OH)", "Fire sprinkler contractor (NC, AR, VA)", "Fuel piping contractor (NC)", "Painting contractor (AZ, AR)", "Concrete contractor (AZ, AR)", "Landscaping and irrigation contractor (AZ, AR)", "Excavation and grading contractor (AZ, AR)", "Carpentry contractor (AZ, AR)", "Training agency (OH)", "Heavy civil, highway, railroad and municipal utility contractor (AR)", "Siding, soffit, fascia and gutters contractor (AR)", "Solar contractor (AR)", "Construction transport contractor (DE)", "Construction manager (DE)", "Professional engineer (DE)", "Architect (DE)", "Landscape architect (DE)", "On-site wastewater and septic system contractor (DE)", "Gas fitting contractor (natural gas and LP) (VA)", "Accessibility contractor (lifts and ramps) (VA)", "Backflow prevention device worker (VA)", "Residential building energy analyst (VA)" ] }, "default": [] }, "onlyActive": { "title": "Only active licences", "type": "boolean", "description": "Drop expired, suspended and out-of-business licences.", "default": false }, "onlyWithPhone": { "title": "Only rows with a phone number", "type": "boolean", "description": "For calling lists.", "default": false }, "onlyExpiringSoon": { "title": "Only licences expiring within 60 days", "type": "boolean", "description": "The renewal window. Who sells bonds, insurance or continuing education wants exactly these.", "default": false }, "maxResults": { "title": "Maximum rows", "minimum": 0, "type": "integer", "description": "0 for no limit.", "default": 0 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }