{ "openapi": "3.0.1", "info": { "title": "Texas Business Entity Search & LLC Leads Scraper", "description": "Look up Texas companies by name, SOS file number or taxpayer number, or export every LLC and corporation formed since a date. Status, NAICS, county, right to transact, agent and officers.", "version": "0.0", "x-build-id": "YFAR7hggEdhC13I3u" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapebench~texas-business-entity-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapebench-texas-business-entity-search", "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/scrapebench~texas-business-entity-search/runs": { "post": { "operationId": "runs-sync-scrapebench-texas-business-entity-search", "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/scrapebench~texas-business-entity-search/run-sync": { "post": { "operationId": "run-sync-scrapebench-texas-business-entity-search", "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": [ "auto", "export", "lookup" ], "type": "string", "description": "export: every Texas business that matches the filters below (e.g. LLCs formed since a date in Houston). lookup: find the companies you name in `Business names or entity IDs` (KYB / due diligence). auto: lookup when you give names, export otherwise.", "default": "auto" }, "queries": { "title": "Business names or entity IDs", "type": "array", "description": "Lookup mode: one company name, Texas SOS file number or 11-digit Comptroller taxpayer number per line. A name matches anywhere in the registered name. Filters below still apply (e.g. only Active).", "default": [], "items": { "type": "string" } }, "query": { "title": "Business name or entity ID (single)", "type": "string", "description": "Same as the list above, one value. Both are combined if you fill both." }, "entityTypes": { "title": "Entity types", "type": "array", "description": "Keep only these types: LLC, Corporation, Nonprofit, Limited Partnership, LLP, General Partnership, Trust. A Texas type code (CL, CT, CN...) or label also works.", "items": { "type": "string" } }, "statuses": { "title": "Statuses", "type": "array", "description": "Keep only these statuses. \"Active\" means Active or Reinstated with the Secretary of State. Other words match the state's own statuses (e.g. Forfeited Franchise Tax, Dissolved, Not registered with the SOS); an unknown word gives a free note listing them.", "items": { "type": "string" } }, "formedAfter": { "title": "Formed on or after", "type": "string", "description": "Newly formed companies: only entities chartered in Texas (or registered here, if formed elsewhere) on or after this date, YYYY-MM-DD." }, "formedBefore": { "title": "Formed on or before", "type": "string", "description": "Only entities chartered or registered in Texas on or before this date, YYYY-MM-DD." }, "cities": { "title": "Cities", "type": "array", "description": "Keep only businesses whose address on file with the Comptroller (a mailing address) is in one of these cities, e.g. Houston, Austin.", "items": { "type": "string" } }, "nameKeywords": { "title": "Name contains (any of)", "type": "array", "description": "Keep only businesses whose name contains one of these words, e.g. construction, roofing, nail, dental.", "items": { "type": "string" } }, "minYearsInBusiness": { "title": "Minimum years in business", "minimum": 0, "type": "integer", "description": "Established businesses: active Texas-chartered entities formed at least this many years ago." }, "maxYearsInBusiness": { "title": "Maximum years in business", "minimum": 0, "type": "integer", "description": "Active Texas-chartered entities formed at most this many years ago." }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "2 to 6 digit NAICS prefixes, e.g. 2381 (foundation and structure contractors), 8121 (personal care). Filtered at the source on the NAICS code the Comptroller publishes (about 632,000 entities have one).", "items": { "type": "string" } }, "includeOfficers": { "title": "Include registered agent and officers", "type": "boolean", "description": "Add the registered agent and office, state of formation, DBA name and the officers and directors from the latest Public Information Report. One read per row, at most 1,000 rows a run (the rest are delivered without them, with a free note). Officers come with the entity's own address only, never a home address.", "default": false }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Cap on rows returned (bounds cost). Up to 100,000 for a statewide export.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. The Texas Comptroller's open data answers directly; if a run answers with a free 'blocked' note, run again with a US proxy.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }