# US Business Entity Scraper — KYB, Agent & Filing Data (`scrapersdelight/us-business-entity-scraper`) Actor

Scrape US business entity / KYB records by state — legal name, entity ID, status, type, filing date, registered agent + address, jurisdiction. Public Socrata open-data APIs (NY, CO, OR, HI). Name search, no login, no API key. Export JSON/CSV.

- **URL**: https://apify.com/scrapersdelight/us-business-entity-scraper.md
- **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community)
- **Categories:** Automation, Lead generation, Agents
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.50 / 1,000 per business entity returneds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## 🏛️ US Business Entity & KYB Scraper — Registered Agent, Status & Filing Data

**Scrape US business-entity / KYB records straight from the states' own registries — legal name, entity ID, status, entity type, filing date, registered agent + address, and jurisdiction — normalized into one clean schema. Search by company name, export to JSON/CSV. No login, no API key.**

> 🕒 Last updated: 2026-07-09 · 🏛️ Official state open-data (Socrata) · 🚫 No API key or login · 💵 $1.50 / 1,000 records · 🔎 Full-text name search

A **Know-Your-Business (KYB)** and **company-registry** data source built directly on each state's **official Secretary-of-State / business-registry open-data API**. Pull every registered company in a state, or search by name, and get the fields KYB, compliance, and B2B lead-gen teams actually need — including the **registered agent** and the **entity status**. One unified schema across every supported state. Export to JSON, CSV, Excel, or Google Sheets, or pull via API.

***

### What it does

- 🏛️ **Straight from the source of truth** — official state business registries (Secretary of State), not a resold aggregator.
- 🧩 **One schema across states** — New York, Colorado, Oregon, and Hawaii normalized into the same fields, so you can pool registries.
- 🔎 **Search by company name** — full-text query, or leave it blank to pull the whole registry (newest first).
- 🕵️ **Registered agent included** — agent name + address, the field most business-data tools omit.
- 🧾 **KYB-ready fields** — legal name, entity ID, status, type, filing date, jurisdiction.

### 🇺🇸 Supported states (phased rollout)

| State | Registry (source) | Status field | Registered agent |
|---|---|---|---|
| **New York** (`ny`) | Active Corporations: Beginning 1800 | active-only file | ✅ (process/agent) |
| **Colorado** (`co`) | Business Entities in Colorado | ✅ Good Standing / Delinquent / … | ✅ |
| **Oregon** (`or`) | Active Businesses – ALL | active-only file | ✅ |
| **Hawaii** (`hi`) | Hawaii Business Registration | ✅ Active / Dissolved / … | ✅ |

> More states are added over time as their registries publish a compatible open-data feed. Ask for a state and we'll prioritize it. NY and Oregon are **active-entity** files, so `status` is returned `null` there (every row is active); Colorado and Hawaii carry an explicit per-record status.

### 📊 Output fields

| Field | Description |
|---|---|
| `state` | Queried state (NY · CO · OR · HI) |
| `entity_id` | State registry / filing number |
| `entity_name` | Legal company name |
| `status` | Registration status (CO/HI); `null` on active-only files (NY/OR) |
| `entity_type` | Corporation, LLC, nonprofit, … |
| `filing_date` | Formation / registration date (ISO `YYYY-MM-DD`) |
| `jurisdiction` | State/country of formation |
| `registered_agent_name` | Registered agent / process contact |
| `registered_agent_address` | Registered agent's address |
| `principal_address` | Principal / mailing address (where the registry provides it) |
| `source_url` | Link back to the source record |
| `scraped_at` | ISO timestamp of the scrape |

<details><summary>🧾 Sample entity record (Colorado)</summary>

```json
{
  "state": "CO",
  "entity_id": "20251665680",
  "entity_name": "KYLDERON MIST VALLEY LLC",
  "status": "Good Standing",
  "entity_type": "DLLC",
  "filing_date": "2025-06-16",
  "jurisdiction": "CO",
  "registered_agent_name": "KEQIANG DENG",
  "registered_agent_address": "660 Willow Wood Ln, Delta, CO, 81416",
  "principal_address": "660 Willow Wood Ln, Delta, CO, 81416",
  "source_url": "https://data.colorado.gov/resource/4ykn-tg5h.json?entityid=20251665680",
  "scraped_at": "2026-07-09T00:00:00.000Z"
}
```

</details>

***

### Who it's for

- 🛡️ **KYB / compliance & onboarding** — verify a business's legal name, status, and registered agent before you transact.
- 🧲 **B2B sales & lead-gen** — build lists of newly formed companies (filter by name, pull newest-first) with a real registered-agent contact.
- 🏦 **Fintech / lending / insurance** — enrich applicants against the official registry of record.
- 📊 **Researchers & journalists** — map company formations, agents, and jurisdictions over time.

### How to use it

1. Click **Try for free**.
2. Pick a **State**.
3. *(Optional)* type a **company name** to search, and set a **Max results** cap.
4. Click **Start**, then export from the **Dataset** tab, or pull via API.

#### Examples

Every entity in Colorado (newest first), capped at 500:

```json
{ "state": "co", "maxItems": 500 }
```

Search New York for "pizza" companies:

```json
{ "state": "ny", "nameQuery": "pizza", "maxItems": 200 }
```

Pull via API (run-sync):

```bash
curl -X POST "https://api.apify.com/v2/acts/scrapersdelight~us-business-entity-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "state": "co", "nameQuery": "coffee" }'
```

***

### ❓ FAQ

**Where does the data come from?** Each state's own official business-registry open-data API (Socrata). It's public government data — no login, no API key.

**What is KYB?** Know Your Business — verifying a company's legal identity (name, ID, status, registered agent, jurisdiction). This actor returns exactly those fields from the registry of record.

**Can I search by company name?** Yes — set `nameQuery`. It's a full-text search that matches the company name (and agent/address text). Leave it blank to pull the whole registry.

**Does it return the registered agent?** Yes — `registered_agent_name` and `registered_agent_address`, where the state publishes them. (For company agents on some registries, the individual name may be blank.)

**Why is `status` sometimes null?** New York and Oregon publish *active-entity* files, so every row is active and there's no per-row status column. Colorado and Hawaii include an explicit status (Good Standing, Delinquent, Dissolved, …).

**Which states are supported?** New York, Colorado, Oregon, and Hawaii today — more are added as their registries publish a compatible feed.

**How much does it cost?** $1.50 per 1,000 records — pay only for results, free to try.

### Notes & fair use

This actor reads official, public state business-registry open-data APIs. It returns publicly filed company-registration data; it does not access private or non-public records. You are responsible for complying with each data portal's Terms of Service.

# Actor input Schema

## `state` (type: `string`):

Which state's business registry to scrape. Each is a public Secretary-of-State / registry open-data API. Supported: New York, Colorado, Oregon, Hawaii.

## `nameQuery` (type: `string`):

Optional full-text search — only return entities matching this text (e.g. "pizza", "brewing", "acme"). Leave blank to return all entities in the state (newest first). Matches company name, agent, and address text.

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

Cost/speed cap on records returned this run. 0 = every matching entity in the state (up to a 50,000 safety backstop).

## `socrataAppToken` (type: `string`):

Optional free Socrata app token (from any data.<state>.gov developer page). Raises the per-IP rate limit for large runs. Not required for normal use.

## `proxyConfiguration` (type: `object`):

Proxy settings. These are clean public government APIs — the default Apify datacenter proxy is plenty.

## Actor input object example

```json
{
  "state": "ny",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `records` (type: `string`):

The dataset of normalized business-entity / KYB records (one item per entity).

# 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 = {
    "state": "ny"
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapersdelight/us-business-entity-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 = { "state": "ny" }

# Run the Actor and wait for it to finish
run = client.actor("scrapersdelight/us-business-entity-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 '{
  "state": "ny"
}' |
apify call scrapersdelight/us-business-entity-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/fVXTi1RPW00QYUKxZ/builds/U3Fg1ekQXmsQITsmg/openapi.json