{ "openapi": "3.0.1", "info": { "title": "Secretary of State Business Entity Search (KYB): 9 US States", "description": "Secretary of State business entity search (KYB) from official open data in NY, FL, TX, PA, CO, CT, OR, IA and DC. Look up companies by name or ID, or list new LLCs and corporations by formation date and city. Company-level data, no scraping.", "version": "0.1", "x-build-id": "I0QHhboycP4g6r0i6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/postatelier~us-business-entities/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-postatelier-us-business-entities", "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/postatelier~us-business-entities/runs": { "post": { "operationId": "runs-sync-postatelier-us-business-entities", "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/postatelier~us-business-entities/run-sync": { "post": { "operationId": "run-sync-postatelier-us-business-entities", "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": { "queries": { "title": "Company names or IDs", "type": "array", "description": "One per line. Names match at word starts (\"Blue Bottle\" finds \"Blue Bottle Coffee, LLC\"). State IDs (NY DOS ID, Texas taxpayer number, Colorado entity ID, Florida document number…) return that entity. Leave empty to list entities by the filters below.", "items": { "type": "string" } }, "states": { "title": "States", "type": "array", "description": "Leave empty for all: New York, Florida, Texas, Pennsylvania, Colorado, Connecticut, Oregon, Iowa and DC.", "items": { "type": "string", "enum": [ "NY", "FL", "TX", "PA", "CO", "OR", "IA", "DC", "CT" ], "enumTitles": [ "New York", "Florida (new filings, last 62 days)", "Texas", "Pennsylvania", "Colorado", "Oregon", "Iowa", "District of Columbia", "Connecticut" ] } }, "formedWithinDays": { "title": "Formed within the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "New-business lists: entities formed in the last N days, newest first. Needed for Florida (daily filing files, up to 62 days)." }, "formedFrom": { "title": "Formed from", "type": "string", "description": "YYYY-MM-DD (alternative to the rolling window)." }, "formedTo": { "title": "Formed to", "type": "string", "description": "YYYY-MM-DD" }, "city": { "title": "City", "type": "string", "description": "Only entities whose business address is in this city, e.g. \"Austin\"." }, "entityKinds": { "title": "Entity kinds", "type": "array", "description": "Leave empty for all.", "items": { "type": "string", "enum": [ "llc", "corporation", "nonprofit", "partnership", "other" ], "enumTitles": [ "LLC", "Corporation", "Nonprofit", "Partnership", "Other" ] } }, "activeOnly": { "title": "Active entities only", "type": "boolean", "description": "Skip dissolved, withdrawn, revoked and similar entities (where the state publishes status).", "default": true }, "maxResultsPerQuery": { "title": "Max matches per name", "minimum": 1, "maximum": 100, "type": "integer", "description": "Best matches across all states for each name.", "default": 10 }, "maxResults": { "title": "Max entities for filter lists", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Upper limit when listing by filters, shared across states.", "default": 200 }, "onlyNew": { "title": "Only new entities (monitoring)", "type": "boolean", "description": "Skip entities this monitor already returned. Schedule daily with formedWithinDays 3 for a fresh new-business feed. Skipped entities are free.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Keeps separate memory per monitor.", "default": "default" }, "selfCheck": { "title": "Self-check (maintainer)", "type": "boolean", "description": "Maintainer health check. Leave off.", "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 } } } } } } } } } }