{ "openapi": "3.0.1", "info": { "title": "US Business Entity Search: New Business Filings & Leads", "description": "Search official US state business registries by company name, or pull newly registered companies by date, from the states' own open-data APIs (NY, CO, CT, OR, PA, TX). Company records only: no officer, owner or agent-person names. Every row names its source dataset. Pay per record found.", "version": "0.1", "x-build-id": "XLjD2hqqRdSqpqjpN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/enisbodlli~us-business-registry-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-enisbodlli-us-business-registry-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/enisbodlli~us-business-registry-search/runs": { "post": { "operationId": "runs-sync-enisbodlli-us-business-registry-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/enisbodlli~us-business-registry-search/run-sync": { "post": { "operationId": "run-sync-enisbodlli-us-business-registry-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", "required": [ "states" ], "properties": { "states": { "title": "States", "minItems": 1, "maxItems": 8, "uniqueItems": true, "type": "array", "description": "The state registers to read. New York, Colorado, Connecticut, Oregon, Pennsylvania and Texas (Texas: the Comptroller's roll of franchise taxpayers) are read through their official open-data APIs and can be searched by name or listed by date. Minnesota and Kentucky are read through the Secretary of State's own public search, by company name only, one company page at a time (about one company a second). Other states are not covered.", "items": { "type": "string", "enum": [ "NY", "CO", "CT", "OR", "PA", "TX", "MN", "KY" ], "enumTitles": [ "New York", "Colorado", "Connecticut", "Oregon", "Pennsylvania", "Texas (franchise taxpayers)", "Minnesota (name search only)", "Kentucky (name search only)" ] } }, "nameQueries": { "title": "Company names", "maxItems": 500, "uniqueItems": true, "type": "array", "description": "Company names to look up, one per line. Each name is searched in every chosen state, in the company-name column only. Upper and lower case do not matter. Leave empty to list companies by registration date instead (not possible in Minnesota and Kentucky, which are searched by name only). Up to 500 names per run, 2 to 200 characters each.", "items": { "type": "string", "minLength": 2, "maxLength": 200 } }, "nameQuery": { "title": "Single company name", "minLength": 2, "maxLength": 200, "type": "string", "description": "One company name, for callers that send a single name. It is searched together with the names in \"Company names\"." }, "matchMode": { "title": "Name match", "enum": [ "contains", "exact", "startsWith" ], "type": "string", "description": "How a company name is compared with the register. \"contains\": the register's name holds the text anywhere; the exact name comes first, then names that begin with it. \"exact\": the whole name is equal, punctuation included, so \"Tesla, Inc.\" does not match \"Tesla Inc\". \"startsWith\": the register's name begins with the text. Kentucky's own search finds names that begin with the text, so there \"contains\" works like \"startsWith\".", "default": "contains" }, "registeredWithinDays": { "title": "Registered within the last days", "minimum": 1, "maximum": 36500, "type": "integer", "description": "Only companies registered or formed in the last N days, counted back from today (UTC). Use this for a scheduled feed of new business filings. Do not combine it with the two date fields below." }, "registeredAfter": { "title": "Registered on or after", "type": "string", "description": "Only companies registered or formed on or after this date, written as YYYY-MM-DD." }, "registeredBefore": { "title": "Registered on or before", "type": "string", "description": "Only companies registered or formed on or before this date, written as YYYY-MM-DD." }, "entityTypes": { "title": "Entity types", "maxItems": 5, "uniqueItems": true, "type": "array", "description": "Only these kinds of entity. Each register's own wording is sorted into five groups: limited liability companies, corporations, nonprofit corporations, partnerships (LP, LLP, LLLP, general) and everything else (trusts, cooperatives, associations, assumed names and so on). Leave empty for all.", "items": { "type": "string", "enum": [ "llc", "corporation", "nonprofit", "partnership", "other" ], "enumTitles": [ "LLC", "Corporation", "Nonprofit", "Partnership", "Other" ] } }, "status": { "title": "Status", "enum": [ "any", "active", "inactive" ], "type": "string", "description": "\"active\": only entities the register shows as existing and entitled to do business. \"inactive\": only dissolved, withdrawn, revoked, merged, delinquent or forfeited entities. Colorado, Connecticut and Texas publish a status. Minnesota and Kentucky show a status too. New York, Oregon and Pennsylvania publish active entities only, so \"inactive\" returns nothing from them.", "default": "any" }, "city": { "title": "City", "maxLength": 100, "type": "string", "description": "Only companies whose address is in this city, compared with the whole city name without regard to case. The address is the principal one where the register has it (Colorado, Connecticut, Oregon, Pennsylvania), the mailing address in Texas, the location or service-of-process address in New York, the principal executive office or place of business in Minnesota and the principal office in Kentucky." }, "zip": { "title": "ZIP code", "pattern": "^\\d{3,5}$", "type": "string", "description": "Only companies whose ZIP code begins with these digits: a full 5-digit ZIP or the first 3 or 4 digits of an area. The same address is used as for \"City\"." }, "maxResults": { "title": "Maximum records", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "The run stops after this many company records. You pay per record, so this is also the cap on the cost of the run. Several states share it: each gets an equal part first, and what one state does not use goes to the others. Use \"Maximum records per state\" for a fixed cap per state.", "default": 1000 }, "maxResultsPerState": { "title": "Maximum records per state", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "At most this many records from each state, and for each company name when names are searched. 0 means no cap per state.", "default": 0 }, "onlyNew": { "title": "Only records not returned before", "type": "boolean", "description": "Return only companies that an earlier run of the same saved task has not returned. Use it with a schedule to get each new registration once. The memory is kept per task and state for 400 days; runs started without a task share memory per identical search.", "default": 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 } } } } } } } } } }