{ "openapi": "3.0.1", "info": { "title": "New Business Filings and LLC Leads, 5 State Registries", "description": "Newly formed LLCs, corporations and nonprofits in Colorado, New York, Connecticut, Oregon and Texas from official Secretary of State open data. Formation date, status, addresses, registered agent, NAICS (CT, TX), and a weekly new-business monitor.", "version": "1.0", "x-build-id": "QL9o3y2hSHofO9zEl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dynamic_jingle~new-business-filings-secretary-of-state/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dynamic_jingle-new-business-filings-secretary-of-state", "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/dynamic_jingle~new-business-filings-secretary-of-state/runs": { "post": { "operationId": "runs-sync-dynamic_jingle-new-business-filings-secretary-of-state", "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/dynamic_jingle~new-business-filings-secretary-of-state/run-sync": { "post": { "operationId": "run-sync-dynamic_jingle-new-business-filings-secretary-of-state", "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": { "mode": { "title": "Mode", "enum": [ "search", "newBusinesses" ], "type": "string", "description": "Use \"search\" to export every business matching your filters, for example all LLCs formed in Colorado since October 1. Use \"newBusinesses\" for a scheduled lead feed: each run returns only businesses that were not returned by earlier runs with the same Monitor ID. The first monitor run returns businesses formed since \"Formed on or after\" (default: last 7 days).", "default": "search" }, "states": { "title": "States", "type": "array", "description": "Two-letter codes of the states to include. Supported: CO, NY, CT, OR, TX. Example: [\"TX\", \"CO\"].", "items": { "type": "string", "enum": [ "CO", "NY", "CT", "OR", "TX" ], "enumTitles": [ "Colorado", "New York", "Connecticut", "Oregon", "Texas" ] }, "default": [ "CO", "NY", "CT", "OR", "TX" ] }, "formedAfter": { "title": "Formed on or after", "type": "string", "description": "Only businesses formed or registered on or after this date. Use YYYY-MM-DD (\"2026-10-01\") or a relative value (\"7 days\", \"2 weeks\", \"1 month\"). Leave empty for the last 30 days in search mode (or the whole registry when you search by name), and the last 7 days on the first monitor run." }, "formedBefore": { "title": "Formed on or before", "type": "string", "description": "Optional end date, YYYY-MM-DD or relative. Example: \"2026-09-30\" to export September only. Default: today." }, "entityTypes": { "title": "Entity types", "type": "array", "description": "Return only these normalized entity types. Example: [\"llc\", \"corporation\"] for for-profit leads. Leave empty for all types.", "items": { "type": "string", "enum": [ "llc", "corporation", "nonprofit", "partnership", "dba", "other" ], "enumTitles": [ "LLC", "Corporation (profit, professional, benefit)", "Nonprofit", "Partnership (LP, LLP, LLLP, GP)", "Assumed business name / DBA (Oregon)", "Other (cooperatives, trusts, associations)" ] } }, "jurisdiction": { "title": "Domestic or foreign", "enum": [ "any", "domestic", "foreign" ], "type": "string", "description": "Domestic entities are brand-new businesses formed in the state. Foreign entities are existing out-of-state companies expanding into it. Example: \"domestic\" for brand-new small business leads, \"foreign\" for companies entering a new state.", "default": "any" }, "nameKeyword": { "title": "Business name contains", "type": "string", "description": "Return only businesses whose name contains this text (case-insensitive). Examples: \"ROOFING\", \"DENTAL\", \"HOLDINGS\", \"PIZZA\"." }, "city": { "title": "City", "type": "string", "description": "Exact city name of the principal or mailing address (case-insensitive). Example: \"Denver\", \"Austin\", \"Brooklyn\"." }, "zip": { "title": "ZIP code or prefix", "type": "string", "description": "ZIP code or ZIP prefix of the principal or mailing address. Example: \"78701\" for one ZIP or \"787\" for the Austin area." }, "naicsCodes": { "title": "NAICS codes (CT and TX only)", "type": "array", "description": "Return only businesses whose NAICS industry code starts with one of these codes. Connecticut and Texas publish NAICS; other states are skipped when this is set. Examples: \"238\" (specialty trade contractors), \"5416\" (consulting), \"722\" (restaurants), \"621\" (healthcare practices).", "items": { "type": "string" } }, "status": { "title": "Status", "enum": [ "active", "inactive", "any" ], "type": "string", "description": "Filter by normalized status. New York and Texas publish active entities only. Example: \"active\" for lead lists.", "default": "active" }, "maxResults": { "title": "Max results (total)", "minimum": 0, "type": "integer", "description": "Stop after this many results across all states, to control cost. Example: 100 for a sample, 0 for no limit. In monitor mode, businesses over the limit stay \"new\" and are returned by the next run.", "default": 1000 }, "maxResultsPerState": { "title": "Max results per state", "minimum": 0, "type": "integer", "description": "Cap per state so one big state (New York and Texas file about 1,000 new entities a day) does not use the whole budget. Example: 200. 0 means no per-state cap.", "default": 0 }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Name of the monitor's memory of businesses already returned. Use a different ID for each scheduled feed. Example: \"tx-llc-weekly\" or \"denver-new-businesses\". Only used in newBusinesses mode.", "default": "default" }, "lookbackDays": { "title": "Monitor look-back window (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "How far back each monitor run re-checks, so filings that a state posts late are still caught. Example: 60. Only used in newBusinesses mode.", "default": 60 } } }, "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 } } } } } } } } } }