{
  "openapi": "3.0.1",
  "info": {
    "title": "New York Secretary of State Business Entity Search Scraper",
    "description": "Search New York's free public business entity database by entity name, ID number, registered agent, county, entity type, jurisdiction, city, or officer name. Get entity type, formation date, registered agent, and business address details.",
    "version": "1.0",
    "x-build-id": "zz14RSWgMafU5qUBq"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/crawlerbros~new-york-sos-business-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-crawlerbros-new-york-sos-business-search-scraper",
        "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/crawlerbros~new-york-sos-business-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-crawlerbros-new-york-sos-business-search-scraper",
        "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/crawlerbros~new-york-sos-business-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-crawlerbros-new-york-sos-business-search-scraper",
        "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": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Search mode",
            "enum": [
              "byEntityName",
              "byIdentificationNumber",
              "byRegisteredAgent",
              "byCounty",
              "byEntityType",
              "byJurisdiction",
              "byCity",
              "byOfficerName",
              "byZipCode",
              "byState"
            ],
            "type": "string",
            "description": "Which search axis to use.",
            "default": "byEntityName"
          },
          "entityName": {
            "title": "Entity name (mode=byEntityName)",
            "type": "string",
            "description": "Business entity name to search for, e.g. `AMAZON`.",
            "default": "AMAZON"
          },
          "entityNameMatchType": {
            "title": "Entity name match type (mode=byEntityName)",
            "enum": [
              "startsWith",
              "contains",
              "exact"
            ],
            "type": "string",
            "description": "How `entityName` is matched.",
            "default": "startsWith"
          },
          "idNumbers": {
            "title": "DOS ID number(s) (mode=byIdentificationNumber)",
            "type": "array",
            "description": "One or more exact New York DOS ID numbers, e.g. `4087072`.",
            "items": {
              "type": "string"
            }
          },
          "agentName": {
            "title": "Registered agent name (mode=byRegisteredAgent)",
            "type": "string",
            "description": "Registered agent name to search for, e.g. `CT CORPORATION SYSTEM`."
          },
          "agentMatchType": {
            "title": "Agent name match type (mode=byRegisteredAgent)",
            "enum": [
              "startsWith",
              "contains"
            ],
            "type": "string",
            "description": "How `agentName` is matched.",
            "default": "contains"
          },
          "county": {
            "title": "County (mode=byCounty)",
            "enum": [
              "Albany",
              "Allegany",
              "Bronx",
              "Broome",
              "Cattaraugus",
              "Cayuga",
              "Chautauqua",
              "Chemung",
              "Chenango",
              "Clinton",
              "Columbia",
              "Cortland",
              "Delaware",
              "Dutchess",
              "Erie",
              "Essex",
              "Franklin",
              "Fulton",
              "Genesee",
              "Greene",
              "Hamilton",
              "Herkimer",
              "Jefferson",
              "Kings",
              "Lewis",
              "Livingston",
              "Madison",
              "Monroe",
              "Montgomery",
              "Nassau",
              "New York",
              "Niagara",
              "Oneida",
              "Onondaga",
              "Ontario",
              "Orange",
              "Orleans",
              "Oswego",
              "Otsego",
              "Putnam",
              "Queens",
              "Rensselaer",
              "Richmond",
              "Rockland",
              "Saratoga",
              "Schenectady",
              "Schoharie",
              "Schuyler",
              "Seneca",
              "St. Lawrence",
              "Steuben",
              "Suffolk",
              "Sullivan",
              "Tioga",
              "Tompkins",
              "Ulster",
              "Warren",
              "Washington",
              "Wayne",
              "Westchester",
              "Wyoming",
              "Yates"
            ],
            "type": "string",
            "description": "New York county where the entity's service-of-process address is located.",
            "default": "New York"
          },
          "entityType": {
            "title": "Entity type (mode=byEntityType)",
            "enum": [
              "DOMESTIC LIMITED LIABILITY COMPANY",
              "DOMESTIC BUSINESS CORPORATION",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION",
              "FOREIGN LIMITED LIABILITY COMPANY",
              "FOREIGN BUSINESS CORPORATION",
              "DOMESTIC PROFESSIONAL SERVICE CORPORATION",
              "DOMESTIC PROFESSIONAL SERVICE LIMITED LIABILITY COMPANY",
              "FOREIGN LIMITED PARTNERSHIP",
              "DOMESTIC LIMITED PARTNERSHIP",
              "FOREIGN NOT-FOR-PROFIT CORPORATION",
              "DOMESTIC REGISTERED LIMITED LIABILITY PARTNERSHIP",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (HOUSING DEVELOPMENT FUND COMPANY) (ARTICLE XI)",
              "FOREIGN PROFESSIONAL SERVICE CORPORATION",
              "DOMESTIC BENEVOLENT ORDER",
              "FOREIGN PROFESSIONAL SERVICE LIMITED LIABILITY COMPANY",
              "DOMESTIC BENEFIT CORPORATION",
              "DOMESTIC HOUSING DEVELOPMENT FUND COMPANY (ARTICLE XI)",
              "FOREIGN GENERAL ASSOCIATION",
              "DOMESTIC COOPERATIVE CORPORATION",
              "NEW YORK REGISTERED FOREIGN LIMITED LIABILITY PARTNERSHIP",
              "DOMESTIC GENERAL ASSOCIATION",
              "DOMESTIC RELIGIOUS CORPORATION",
              "DOMESTIC TRANSPORTATION CORPORATION",
              "DOMESTIC DESIGN PROFESSIONAL SERVICE CORPORATION",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (BOARD OF TRADE AND CHAMBER OF COMMERCE CORPORATION)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (UNIVERSITY FACULTY PRACTICE CORPORATION)",
              "DOMESTIC PUBLIC BENEFIT CORPORATION",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (COMMUNITY MENTAL HEALTH SERVICES AND MENTAL RETARDATION SERVICES COMPANIES)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (LOCAL DEVELOPMENT CORPORATION)",
              "DOMESTIC LIMITED-PROFIT HOUSING COMPANY (ARTICLE 2 PHFL & NPCL)",
              "DOMESTIC COOPERATIVE CORPORATION (WORKER COOPERATIVE)",
              "DOMESTIC REDEVELOPMENT COMPANY (ARTICLE V)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (LAND BANK)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (FIRE CORPORATION)",
              "DOMESTIC REDEVELOPMENT COMPANY (LIMITED LIABILITY COMPANY)",
              "DOMESTIC JOINT STOCK ASSOCIATION",
              "UNAUTHORIZED FOREIGN BUSINESS CORPORATION",
              "DOMESTIC LIMITED-PROFIT HOUSING COMPANY (ARTICLE 2 PHFL & BCL)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (PUBLIC CEMETERY CORPORATION)",
              "DOMESTIC NOT-FOR-PROFIT CORPORATION (MILITIA ASSOCIATION)",
              "DOMESTIC RAILROAD CORPORATION",
              "DOMESTIC GOVERNMENTAL AGENCY",
              "GENERAL ASSOCIATION DESIGNATION",
              "DOMESTIC REDEVELOPMENT COMPANY (LIMITED PARTNERSHIP)",
              "DOMESTIC RELIGIOUS CORPORATION (GOVERNING OR ADVISORY BODY)",
              "UNAUTHORIZED BUSINESS CORPORATION",
              "DOMESTIC CONDOMINIUM DECLARATION",
              "FOREIGN DESIGNATION OF THE SECRETARY OF STATE",
              "RESERVATION OF DOMESTIC NOT FOR PROFIT CORPORATION",
              "UNAUTHORIZED FOREIGN LIMITED LIABILITY COMPANY",
              "FOREIGN COOPERATIVE CORPORATION",
              "FOREIGN RELIGIOUS CORPORATION",
              "DOMESTIC CONDOMINIUM"
            ],
            "type": "string",
            "description": "Type of business entity, as recorded by NY DOS.",
            "default": "DOMESTIC LIMITED LIABILITY COMPANY"
          },
          "jurisdiction": {
            "title": "Jurisdiction (mode=byJurisdiction)",
            "enum": [
              "New York",
              "Delaware",
              "New Jersey",
              "Florida",
              "California",
              "Pennsylvania",
              "Connecticut",
              "Nevada",
              "Texas",
              "Massachusetts",
              "Illinois",
              "Ohio",
              "Maryland",
              "Wyoming",
              "Georgia",
              "Virginia",
              "Michigan",
              "Colorado",
              "North Carolina",
              "Minnesota",
              "Missouri",
              "Washington",
              "Indiana",
              "District of Columbia",
              "Arizona",
              "Tennessee",
              "Wisconsin",
              "Vermont",
              "Utah",
              "New Hampshire",
              "Oregon",
              "South Carolina",
              "Maine",
              "Kentucky",
              "Louisiana",
              "Rhode Island",
              "Oklahoma",
              "Kansas",
              "Alabama",
              "Iowa",
              "Alaska",
              "Nebraska",
              "New Mexico",
              "Arkansas",
              "Idaho",
              "Montana",
              "West Virginia",
              "South Dakota",
              "Mississippi",
              "Hawaii",
              "North Dakota",
              "Puerto Rico",
              "Guam",
              "American Samoa",
              "U.S. Virgin Islands",
              "U.S. Minor Outlying Islands",
              "Ontario",
              "Quebec",
              "British Columbia",
              "Alberta",
              "New Brunswick",
              "Nova Scotia",
              "Manitoba",
              "Prince Edward Island",
              "Newfoundland",
              "Saskatchewan",
              "Northwest Territories",
              "Nunavut",
              "England",
              "England-Wales",
              "Scotland",
              "Wales",
              "Northern Ireland",
              "Marshall Islands",
              "Palau",
              "Federated States of Micronesia",
              "Canal Zone",
              "Caroline Islands",
              "Wake Island",
              "Armed Forces Pacific",
              "Armed Forces (Africa, Canada, Europe, Middle East)"
            ],
            "type": "string",
            "description": "State, US territory, Canadian province, or country where the entity was originally formed (New York = domestic; anything else = foreign).",
            "default": "Delaware"
          },
          "city": {
            "title": "City (mode=byCity)",
            "type": "string",
            "description": "City of the entity's service-of-process address, e.g. `BROOKLYN`.",
            "default": "BROOKLYN"
          },
          "cityMatchType": {
            "title": "City match type (mode=byCity)",
            "enum": [
              "startsWith",
              "contains"
            ],
            "type": "string",
            "description": "How `city` is matched.",
            "default": "startsWith"
          },
          "officerName": {
            "title": "Officer/CEO name (mode=byOfficerName)",
            "type": "string",
            "description": "Officer/chairman/CEO name on file to search for. Only populated for a subset of entities (mostly not-for-profits and older filings)."
          },
          "officerMatchType": {
            "title": "Officer name match type (mode=byOfficerName)",
            "enum": [
              "startsWith",
              "contains"
            ],
            "type": "string",
            "description": "How `officerName` is matched.",
            "default": "contains"
          },
          "zipCode": {
            "title": "ZIP code (mode=byZipCode)",
            "type": "string",
            "description": "5-digit US ZIP code of the entity's service-of-process address, e.g. `10001`. ZIP+4 is accepted and truncated to 5 digits.",
            "default": "10001"
          },
          "state": {
            "title": "State (mode=byState)",
            "enum": [
              "AL",
              "AK",
              "AZ",
              "AR",
              "CA",
              "CO",
              "CT",
              "DE",
              "DC",
              "FL",
              "GA",
              "HI",
              "ID",
              "IL",
              "IN",
              "IA",
              "KS",
              "KY",
              "LA",
              "ME",
              "MD",
              "MA",
              "MI",
              "MN",
              "MS",
              "MO",
              "MT",
              "NE",
              "NV",
              "NH",
              "NJ",
              "NM",
              "NY",
              "NC",
              "ND",
              "OH",
              "OK",
              "OR",
              "PA",
              "RI",
              "SC",
              "SD",
              "TN",
              "TX",
              "UT",
              "VT",
              "VA",
              "WA",
              "WV",
              "WI",
              "WY",
              "AS",
              "GU",
              "MP",
              "PR",
              "VI",
              "AE",
              "AA",
              "AP",
              "MH",
              "PW",
              "CZ"
            ],
            "type": "string",
            "description": "US state/territory (2-letter postal code) of the entity's service-of-process address. Note this is the mailing-address state, not the jurisdiction of formation -- use `byJurisdiction` for that.",
            "default": "NY"
          },
          "formationDateFrom": {
            "title": "Formation date from (all modes)",
            "type": "string",
            "description": "Optional: only include entities formed/registered on or after this date, format `YYYY-MM-DD`."
          },
          "formationDateTo": {
            "title": "Formation date to (all modes)",
            "type": "string",
            "description": "Optional: only include entities formed/registered on or before this date, format `YYYY-MM-DD`."
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Hard cap on emitted records.",
            "default": 25
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}