{
  "openapi": "3.0.1",
  "info": {
    "title": "New Business Registrations: New LLC & Corporation Leads",
    "description": "Find newly registered LLCs, corporations and nonprofits from official state business registries (NY, CO, OR, CT). Filter by keyword, entity type, city or ZIP. Registered agent, address, email (CT). 'Only new' mode for daily new-business lead alerts. No API key, no login.",
    "version": "0.1",
    "x-build-id": "eyypgfpQEVSd52wKx"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/radiant_opuntia~new-business-registrations-alerts/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-radiant_opuntia-new-business-registrations-alerts",
        "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/radiant_opuntia~new-business-registrations-alerts/runs": {
      "post": {
        "operationId": "runs-sync-radiant_opuntia-new-business-registrations-alerts",
        "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/radiant_opuntia~new-business-registrations-alerts/run-sync": {
      "post": {
        "operationId": "run-sync-radiant_opuntia-new-business-registrations-alerts",
        "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": "Which Secretary-of-State business registries to search. Each one is the state's official open-data feed.",
            "items": {
              "type": "string",
              "enum": [
                "ny",
                "co",
                "or",
                "ct"
              ],
              "enumTitles": [
                "New York (DOS corporation filings)",
                "Colorado (SOS business entities)",
                "Oregon (SOS active businesses)",
                "Connecticut (business registry)"
              ]
            },
            "default": [
              "ny",
              "co",
              "or",
              "ct"
            ]
          },
          "keyword": {
            "title": "Keyword in business name or record",
            "type": "string",
            "description": "Full-text match on the record (name, address, agent). Examples: 'roofing', 'holdings', 'cannabis', 'capital'. Leave empty for all."
          },
          "entityKinds": {
            "title": "Entity kinds",
            "type": "array",
            "description": "Only keep these kinds of registrations. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "llc",
                "corporation",
                "nonprofit",
                "partnership",
                "assumed_name",
                "other"
              ],
              "enumTitles": [
                "LLCs (incl. professional LLCs)",
                "Corporations",
                "Nonprofits",
                "Partnerships (LP, LLP...)",
                "Assumed business names (Oregon)",
                "Other"
              ]
            },
            "default": []
          },
          "origin": {
            "title": "Domestic or foreign",
            "enum": [
              "any",
              "domestic",
              "foreign"
            ],
            "type": "string",
            "description": "Domestic = formed in that state. Foreign = formed elsewhere and registered to do business there.",
            "default": "any"
          },
          "cities": {
            "title": "Cities",
            "type": "array",
            "description": "Only businesses whose listed address is in one of these cities, e.g. 'Denver', 'Brooklyn', 'Portland'. Leave empty for all.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "zipCodes": {
            "title": "ZIP codes",
            "type": "array",
            "description": "Only businesses at these 5-digit ZIP codes (address as published by the state). Leave empty for all.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "registeredWithinDays": {
            "title": "Registered within last N days",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Registrations filed in the last N days. Ignored if a start date is set. States publish with a delay of 0 to 3 days.",
            "default": 7
          },
          "startDate": {
            "title": "Start date (optional)",
            "type": "string",
            "description": "Earliest registration date, YYYY-MM-DD. Overrides 'Registered within last N days'."
          },
          "endDate": {
            "title": "End date (optional)",
            "type": "string",
            "description": "Latest registration date, YYYY-MM-DD. Defaults to today."
          },
          "onlyNew": {
            "title": "Only new since last run (alerts mode)",
            "type": "boolean",
            "description": "Remember which businesses were already returned and output only newly registered ones. Ideal with a daily Schedule + email/Slack/webhook integration.",
            "default": false
          },
          "stateKey": {
            "title": "Alert name (optional)",
            "type": "string",
            "description": "Separate memory for 'only new' mode. Defaults to a key derived from your filters."
          },
          "socrataAppToken": {
            "title": "Socrata app token (optional)",
            "type": "string",
            "description": "Not needed. Anonymous access is enough for alerts. A free app token from the state's data portal raises rate limits for very large pulls."
          },
          "maxResultsPerState": {
            "title": "Max results per state",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Stop after this many registrations per state.",
            "default": 500
          },
          "maxResults": {
            "title": "Max results (total)",
            "minimum": 1,
            "maximum": 200000,
            "type": "integer",
            "description": "Stop after this many registrations in total.",
            "default": 2000
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}