{ "openapi": "3.0.1", "info": { "title": "Us State Contractor License Scraper", "description": "Look up official California CSLB, Florida DBPR and Texas TDLR records. Extract license status, expiration dates, public contacts and renewal flags, plus available California bond and workers' compensation details. Export data for verification and prospecting.", "version": "0.0", "x-build-id": "GvTbJvgWbMOLfeTSy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arezdev~us-state-contractor-license-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arezdev-us-state-contractor-license-scraper", "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/arezdev~us-state-contractor-license-scraper/runs": { "post": { "operationId": "runs-sync-arezdev-us-state-contractor-license-scraper", "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/arezdev~us-state-contractor-license-scraper/run-sync": { "post": { "operationId": "run-sync-arezdev-us-state-contractor-license-scraper", "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": { "state": { "title": "State database", "enum": [ "TX", "CA", "FL" ], "type": "string", "description": "Choose the official state licensing database.", "default": "TX" }, "licenseNumbers": { "title": "License numbers", "maxItems": 5000, "type": "array", "description": "Optional exact numbers. Required for California. Exact lookup ignores city and trade category; status and expiration filters still apply. Texas requires the numeric portion only.", "items": { "type": "string" } }, "tradeCategory": { "title": "Trade category", "enum": [ "ALL", "ELECTRICAL", "HVAC_ACR", "PLUMBING", "ROOFING", "GENERAL_BUILDING" ], "type": "string", "description": "Discovery filter. Texas supports electrical and HVAC through TDLR; ALL includes only supported construction trades.", "default": "HVAC_ACR" }, "city": { "title": "City", "maxLength": 80, "type": "string", "description": "Optional discovery filter. Leave empty for statewide search. Texas records without a published city cannot match a city filter. Enter a city such as MIAMI to narrow Florida discovery.", "default": "" }, "onlyActive": { "title": "Only active licenses", "type": "boolean", "description": "Exclude inactive or expired licenses. Texas open data has no status field: unexpired dates are used as a proxy and labeled explicitly.", "default": true }, "expiringWithinDays": { "title": "Expiring within days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Include licenses expiring today through this many days from today, inclusive." }, "maxItems": { "title": "Maximum saved records", "minimum": 1, "maximum": 5000, "type": "integer", "description": "SUCCESS and ERROR rows both count. Free Apify plans are capped at 25 records per run.", "default": 50 }, "timeoutSecs": { "title": "Request timeout (seconds)", "minimum": 3, "maximum": 60, "type": "integer", "description": "Timeout for each HTTP attempt, including DNS validation.", "default": 15 }, "maxConcurrency": { "title": "Maximum concurrency", "minimum": 1, "maximum": 100, "type": "integer", "description": "Parallel exact lookups. HTML government portals are additionally limited to 3 concurrent lookups.", "default": 25 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Texas always uses direct connections. Other states start direct and may use datacenter fallback. Residential fallback requires explicit enablement. Disable Apify proxy to force direct requests." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }