{ "openapi": "3.0.1", "info": { "title": "New Business Registrations Scraper: Secretary of State NY CO CT", "description": "New business registrations from Secretary of State open data for New York, Colorado and Connecticut: name, registration number, entity type, date, status, address and registered agent. Filter by state, date, type, name or city, look up numbers, or monitor and get only new businesses.", "version": "0.1", "x-build-id": "gFKYQcTWFWTVv8NB2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~us-new-business-registrations-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-us-new-business-registrations-monitor", "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/neverempty~us-new-business-registrations-monitor/runs": { "post": { "operationId": "runs-sync-neverempty-us-new-business-registrations-monitor", "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/neverempty~us-new-business-registrations-monitor/run-sync": { "post": { "operationId": "run-sync-neverempty-us-new-business-registrations-monitor", "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": { "states": { "title": "States", "type": "array", "description": "States to read: NY (New York), CO (Colorado), CT (Connecticut). One per line. Leave empty for all three. New York describes its dataset as posted monthly; on 2026-10-05 it held registrations up to the day before. Other states are not covered; Florida is in the separate Actor neverempty/florida-sunbiz-scraper.", "items": { "type": "string" } }, "registeredInLastDays": { "title": "Registered in the last N days", "minimum": 0, "maximum": 36500, "type": "integer", "description": "Keep businesses whose registration date is within this many days before today (UTC). The states publish about once a day and the newest one or two dates are still filling in. Leave empty for no lower date. Not used in monitoring mode." }, "registeredFrom": { "title": "Registered on or after", "type": "string", "description": "Keep businesses registered on or after this date (YYYY-MM-DD). If \"Registered in the last N days\" is also set, the later of the two dates is used. Not used in monitoring mode." }, "registeredTo": { "title": "Registered on or before", "type": "string", "description": "Keep businesses registered on or before this date (YYYY-MM-DD). Not used in monitoring mode." }, "entityKinds": { "title": "Kind of business", "type": "array", "description": "Keep these kinds. Each state names its entity types differently; the README lists which state types fall under each kind. The state's own type is always in the row as entityType. Leave empty for every kind.", "items": { "type": "string", "enum": [ "llc", "corporation", "nonprofit", "partnership" ], "enumTitles": [ "LLC", "Corporation (for profit)", "Nonprofit corporation", "Partnership (LP, LLP, GP)" ] } }, "nameContains": { "title": "Business name contains", "type": "array", "description": "Keep businesses whose name contains any of these words or phrases (not case-sensitive). One per line. With no date filter this is a name search across the whole registry data of the state.", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Keep businesses in these cities (exact city name, not case-sensitive). Colorado: principal address city. Connecticut: business address city. New York: city of the address for service of process, which is not always where the business is.", "items": { "type": "string" } }, "statuses": { "title": "Statuses", "type": "array", "description": "Keep businesses with these statuses (exact, not case-sensitive), for example Active for Connecticut or Good Standing for Colorado. New York data has no status: it lists active businesses only, so this filter is not applied to New York.", "items": { "type": "string" } }, "includeRejected": { "title": "Include rejected filings (Connecticut)", "type": "boolean", "description": "Connecticut data includes filings the state rejected (status Rejected, about 5% of recent rows). They are left out unless you turn this on or name Rejected in \"Statuses\". Lookups by registration number always return the record as it is.", "default": false }, "maxBusinesses": { "title": "Maximum businesses", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many business rows in total. With several states the number is shared evenly between them. Not used in monitoring mode, which returns every new business.", "default": 200 }, "registrationNumbers": { "title": "Registration numbers", "type": "array", "description": "Look up businesses by registration number instead of searching: Colorado entity ID, New York DOS ID, Connecticut account number. Each number is looked up in the states set above. The search filters are not used.", "items": { "type": "string" } }, "monitoringMode": { "title": "Monitoring mode", "type": "boolean", "description": "Return only businesses that were not there at the previous monitoring run with the same states and filters. The first run remembers what is listed and returns no business row. Compares the registration numbers of the last 30 days, so businesses added late under an earlier date are still returned.", "default": false }, "resetMonitoringState": { "title": "Reset monitoring memory", "type": "boolean", "description": "Forget what earlier monitoring runs with these states and filters remembered, and start again with a first run.", "default": false }, "includePeople": { "title": "Include people and contact details", "type": "boolean", "description": "Include the registered agent (often a private person, with address) and, for Connecticut, the business email address. These are public registry records; you are responsible for how you use personal data. Turn off to leave them out.", "default": true } } }, "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 } } } } } } } } } }