# NY Business Registry Scraper (`parseforge/apps-scraper`) Actor

Find and export official New York business registry records by entity name, DOS ID, assumed name, or assumed name ID. Get clear, structured results with status, filing date, county, and jurisdiction to support due diligence, compliance checks, partner screening, and market research.

- **URL**: https://apify.com/parseforge/apps-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Automation, Developer tools, Other
- **Stats:** 4 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 📋 NY Business Registry Scraper — New York Corporation Search

**Scrape New York business registry records from the NY Department of State.** Extract company name, entity type, filing date, DOS ID, registered agent, corporate address, and current status. Search by company name or browse by filing date range. Export as JSON, CSV, Excel, XML, or JSONL.

### 🎯 Target Audience | Use Cases

| Audience | What they get |
|----------|---------------|
| **Compliance teams** | Entity status verification, registered agent tracking, filing history |
| **Legal & due diligence** | Company background checks, corporate structure research |
| **Lead generation** | New business filings, entity-type prospecting |
| **Data analysts** | Business formation trends, industry category analysis |

### ⚙️ What the Scraper Does

Scrapes the New York Department of State business registry at scale.

- **Company search** — search by entity name (exact or partial match)
- **Entity type filter** — LLC, Corporation, LLP, Non-Profit, etc.
- **Date range** — filter by filing date (formation or latest amendment)
- **Full record extraction** — DOS ID, registered agent, address, status, filing history

### 🚀 How to Use

1. **[Sign up for Apify](https://console.apify.com/sign-up?fpr=vmoqkp)**
2. **Enter a company name** — partial match works (e.g. "Acme" finds "Acme Corp", "Acme LLC", etc.)
3. **Set filters** — entity type, status, filing date range
4. **Run** — results in the dataset tab
5. **Export** as JSON, CSV, Excel, XML, or JSONL

### 💡 More ParseForge Actors

1,500+ keyless scrapers. Check the store for other state registries, SEC filings, and business databases.

### ⚠️ Disclaimer

This scraper accesses publicly available NY Department of State data. Users are responsible for compliance with applicable terms.

### 📊 Data fields

Each record includes: `assumedName`, `assumedNameID`, `county`, `dosID`, `entityName`, `entityStatus`, `entityType`, `entityTypeCategory`, `initialFilingDate`, `jurisdiction`, `nameType`, `nonQualifiedID`, `scrapedAt`. All 13 field names come from a real production run, so what you see here is what lands in your dataset.

### 🆘 Need Help?

If you hit a bug, have questions about setup, or need a scraper we haven't built yet, open our [contact form](https://tally.so/r/BzdKgA) or write to parseforge@protonmail.com. We also take on paid custom data projects.

For faster answers, join our [Discord](https://parseforge.co/discord). It's the best place to get support and suggest new actors.

# Actor input Schema

## `maxItems` (type: `integer`):

How many business registry records to collect per run.

## `searchValue` (type: `string`):

Name, DOS ID, or assumed name to search. Leave empty to run a broad prefix scan.

## `searchByTypeIndicator` (type: `string`):

Field used for matching your search value.

## `searchExpressionIndicator` (type: `string`):

How the value should match: contains, starts with, or base word.

## `entityStatusIndicator` (type: `string`):

Filter by registration status.

## `entityTypeIndicator` (type: `array`):

Entity types to include in results.

## Actor input object example

```json
{
  "maxItems": 10,
  "searchValue": "APPLE",
  "searchByTypeIndicator": "EntityName",
  "searchExpressionIndicator": "Contains",
  "entityStatusIndicator": "AllStatuses",
  "entityTypeIndicator": [
    "Corporation",
    "LimitedLiabilityCompany",
    "LimitedPartnership",
    "LimitedLiabilityPartnership"
  ]
}
```

# Actor output Schema

## `overview` (type: `string`):

Dataset view with key business fields in table format.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 10,
    "searchValue": "APPLE"
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/apps-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxItems": 10,
    "searchValue": "APPLE",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/apps-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxItems": 10,
  "searchValue": "APPLE"
}' |
apify call parseforge/apps-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/apps-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/AVSZVuXYFmlxNxHIK/builds/ONOwdOyDywDVj0xBO/openapi.json