{ "openapi": "3.0.1", "info": { "title": "New Business Filings Feed: new LLCs in 7 US states", "description": "Newly registered businesses from official state data (FL, CO, CT, NY, OR, TX, DE) in one schema, daily, deduplicated, with registered-agent and mass-filer addresses filtered out and a likely industry tag.", "version": "0.1", "x-build-id": "PSijzTu3mWmpSIksB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/longlever~new-business-filings-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-longlever-new-business-filings-feed", "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/longlever~new-business-filings-feed/runs": { "post": { "operationId": "runs-sync-longlever-new-business-filings-feed", "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/longlever~new-business-filings-feed/run-sync": { "post": { "operationId": "run-sync-longlever-new-business-filings-feed", "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 include. Colorado, Connecticut, Florida and New York are new entity filings (LLCs, corporations, foreign registrations); Florida and Oregon add new fictitious or assumed business names (DBAs). Texas is new sales tax permits and Delaware is new business licenses, because those two states do not publish their filings. Leave empty for all seven.", "items": { "type": "string", "enum": [ "CO", "CT", "FL", "NY", "OR", "TX", "DE" ], "enumTitles": [ "Colorado (CO)", "Connecticut (CT)", "Florida (FL)", "New York (NY)", "Oregon (OR)", "Texas (TX)", "Delaware (DE)" ] } }, "mode": { "title": "Mode", "enum": [ "new", "window" ], "type": "string", "description": "New since last run returns only businesses this Actor has not returned before for the same filters (schedule it daily). The first run returns the last lookback days. Window returns every business filed in the last lookback days, every run.", "default": "new" }, "lookbackDays": { "title": "Lookback days", "minimum": 1, "maximum": 30, "type": "integer", "description": "Window mode: how many days of filings to return. New mode: how far back the first run goes. Oregon and Texas refresh weekly, so use 7 or more for those in window mode.", "default": 3 }, "excludeAgentAddresses": { "title": "Drop registered-agent addresses", "type": "boolean", "description": "Drop businesses whose only address belongs to a commercial registered agent (Registered Agents Inc, Northwest, CSC, ZenBusiness and about 55 more, plus any agent the state's data names 25+ times).", "default": true }, "excludeMassFilerAddresses": { "title": "Drop mass-filer addresses", "type": "boolean", "description": "Drop businesses at an address shared by many new filings in the last 14 days (virtual offices, formation mills, accountants filing in bulk). Suite numbers are ignored.", "default": true }, "massFilerThreshold": { "title": "Mass-filer threshold", "minimum": 2, "maximum": 1000, "type": "integer", "description": "How many new filings at one address in 14 days make it a mass-filer address.", "default": 10 }, "excludeHoldingCompanies": { "title": "Drop holding and property companies", "type": "boolean", "description": "Drop names like '... Holdings', '... Investments', '... Properties', '... Realty' and street-address LLCs ('148 Main St LLC'), unless the state's own NAICS code or license category says the business operates.", "default": true }, "inStateAddressOnly": { "title": "In-state address only", "type": "boolean", "description": "Drop businesses whose address is outside the state they registered in.", "default": true }, "includeNonprofits": { "title": "Include nonprofits", "type": "boolean", "description": "Nonprofit corporations. Off by default because most buyers sell to for-profit businesses.", "default": false }, "includeForeignRegistrations": { "title": "Include foreign registrations", "type": "boolean", "description": "Entities formed in another state that just registered to do business here.", "default": true }, "includeAssumedNames": { "title": "Include assumed business names (DBAs)", "type": "boolean", "description": "Florida fictitious names, Oregon assumed business names and Delaware trade-name-only registrations.", "default": true }, "includeSoleProprietors": { "title": "Include sole proprietors", "type": "boolean", "description": "Texas permits and Delaware licenses held by individuals, and Florida and Oregon DBAs owned by a person.", "default": true }, "includeAdditionalLocations": { "title": "Include additional locations (Texas)", "type": "boolean", "description": "Texas permits for a second or later location of a business that already had a permit.", "default": false }, "industries": { "title": "Industries (any)", "type": "array", "description": "Keep only these likely industries. Tagged from the state's NAICS code (Connecticut, Texas), license category (Delaware) or the business name.", "items": { "type": "string", "enum": [ "Construction and trades", "Food, beverage and hospitality", "Real estate", "Health care", "Beauty and personal care", "Transportation and logistics", "Automotive", "Professional services", "Finance and insurance", "Technology", "Retail and e-commerce", "Cleaning and facility services", "Fitness and recreation", "Education and childcare", "Arts, media and events", "Agriculture", "Manufacturing", "Wholesale and distribution", "Pets", "Cannabis and hemp", "Holding and investment", "Other services" ] } }, "includeUnknownIndustry": { "title": "Keep untagged businesses when filtering by industry", "type": "boolean", "description": "With an industries list, also keep businesses whose industry could not be guessed (about 4 in 10 have names that say nothing about the trade).", "default": false }, "cities": { "title": "Cities (any)", "type": "array", "description": "Exact city names, for example Denver or Hartford.", "items": { "type": "string" } }, "counties": { "title": "Counties (any)", "type": "array", "description": "County names, for example Kings, Harris, Hillsborough or Westchester. Available for New York, Texas and Florida DBAs.", "items": { "type": "string" } }, "zipPrefixes": { "title": "ZIP code prefixes (any)", "type": "array", "description": "For example 802 for Denver or 06 for all of Connecticut.", "items": { "type": "string" } }, "nameKeywords": { "title": "Name keywords (any)", "type": "array", "description": "Keep businesses whose name contains any of these.", "items": { "type": "string" } }, "excludeNameKeywords": { "title": "Exclude name keywords", "type": "array", "description": "Drop businesses whose name contains any of these.", "items": { "type": "string" } }, "maxItems": { "title": "Max businesses per run", "minimum": 0, "type": "integer", "description": "0 means no limit. In new mode, businesses over the limit come back on the next run.", "default": 0 }, "stateKey": { "title": "State key (new mode)", "type": "string", "description": "Optional name for the saved list of returned businesses. By default it comes from your filters, so changing a filter starts fresh. States share the key, so adding a state keeps the others' history." }, "socrataAppToken": { "title": "Socrata app token (optional)", "type": "string", "description": "A free Socrata app token raises the open data portals' rate limits. Not needed for normal use." } } }, "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 } } } } } } } } } }