New York Business Entity Scraper

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

Event	Price
Actor start	$0.00005 per run
entity-record	$0.01 per stored entity

The actor prints the maximum result-event cost before querying and stops at maxResults or an Apify event-charge limit. A one-result run costs up to $0.01005 in actor events before compute or usage charges.

Official sources

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