New York Business Entity Scraper

Free plan limit: Free-plan users can receive up to 5 result records per run. Paid-plan and local/unknown runs retain the Actor's existing limits.

Search active New York business entities by name or Department of State (DOS) ID through the official New York Open Data active-entity dataset. The actor returns one compact, structured record per unique entity with identity, type, jurisdiction, county, service-of-process, agent, and physical-location fields.

The browser-based Public Inquiry page is useful for human verification, but it can present an automated-browser challenge. This actor uses the state’s published API dataset as its primary transport for predictable, agent-friendly runs.

What it extracts

Group	Fields
Identity	entityName, dosId, entityType, entityStatus
Formation	dateOfInitialDosFiling, jurisdiction, county
Service and contact	serviceOfProcessName, serviceOfProcessAddress, chiefExecutiveOfficerName, chiefExecutiveOfficerAddress, registeredAgentName, registeredAgentAddress
Location	entityPrimaryLocationName, entityPrimaryLocationAddress, principalExecutiveOfficeAddress
Provenance	sourceUrl, searchQuery, search settings, scrapedAt, warnings[]

The official active-entity dataset does not provide every field displayed in the interactive Public Inquiry detail page. Fields not published in Open Data are explicit null. filingLinks[] contains the official active-dataset source link; the actor does not download certified documents or filing history.

When to use it

Use this actor for public New York entity research, DOS-ID resolution, vendor due diligence, company-name lookups, service-of-process research, and compact structured inputs for AI agents.

Do not use it as a final name-availability opinion, a certificate-of-status provider, an ownership/EIN lookup, a private beneficial-owner source, a county-clerk assumed-name search, or a substitute for legal advice. The Department of State warns that public-record completeness and accuracy are not guaranteed.

Input

{
  "searchBy": "entityName",
  "query": "IBM",
  "searchFunctionality": "beginsWith",
  "entityStatus": "active",
  "entityTypes": ["corporation", "limitedLiabilityCompany", "limitedPartnership", "limitedLiabilityPartnership"],
  "maxResults": 50,
  "requestDelayMs": 400
}

For a direct DOS ID lookup:

{ "searchBy": "dosId", "query": "1234567", "maxResults": 1 }

Name matching supports beginsWith, contains, and exactMatch. Entity types are filtered defensively after the API response. entityStatus="active" is the supported source scope; inactive exits with a warning because the active dataset cannot truthfully return inactive-only records.

Output example

{
  "recordType": "ny-business-entity",
  "entityName": "IBM",
  "dosId": "1234567",
  "entityType": "DOMESTIC BUSINESS CORPORATION",
  "entityStatus": "ACTIVE",
  "dateOfInitialDosFiling": "01/01/1900",
  "county": "New York",
  "jurisdiction": "New York",
  "serviceOfProcessName": "IBM",
  "serviceOfProcessAddress": "1 MADISON AVENUE, NEW YORK, NY, 10010",
  "registeredAgentName": null,
  "registeredAgentAddress": null,
  "filingLinks": [
    { "linkType": "other", "label": "Active entities dataset", "url": "https://data.ny.gov/Economic-Development/Active-Corporations-Beginning-1800/n9v6-gdp6" }
  ],
  "sourceUrl": "https://data.ny.gov/resource/n9v6-gdp6.json?...",
  "warnings": ["The official Open Data active-entity dataset is the source for this record; inactive-only records are outside this actor’s source scope."]
}

The OUTPUT key-value record contains status, result and charge counts, the normalized search input, official source links, and warnings. A valid query with no matches is a successful empty result. HTTP, timeout, or API failures are reported as runtime failures rather than silently converted into an empty dataset.

Pricing

This Actor uses pay-per-event pricing. These are the current Apify Store event prices:

Event	Price (USD)	When it is charged
entity-record	$0.01	NY business entity returned — Charged for each unique structured active New York business entity record stored in the dataset.
apify-actor-start	$0.00005	Actor Start — Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). — Charged once per run.

Apify platform usage for this Actor run is included alongside the event prices above; no separate per-run platform-usage fee is passed to users.

This covers Apify platform usage for this Actor run. Other Apify products or usage outside this Actor run may still follow your account plan.

Official sources

• New York Corporation and Business Entity Search Database
• Active Corporations: Beginning 1800
• NY Open Data API endpoint