New York Business Entity Scraper - LLC/Corp Search API

Search the official New York Department of State Division of Corporations public inquiry by legal name or exact DOS ID. Export source-linked entity status, filing dates, service-of-process fields, principal-office/CEO fields, registered-agent details, and stock fields when the source reports them.

This actor is designed for KYB evidence, vendor/customer onboarding checks, New York LLC and corporation lookup, legal-record research, and entity-data enrichment. It uses the backend of the official public inquiry—no browser, proxy, CAPTCHA service, or buyer API key is required.

Safe first run

Empty input returns one deterministic, detail-rich record:

{
  "dosIds": ["4381949"],
  "fetchDetails": true,
  "maxResults": 1
}

The fixture is GOLDMAN SACHS BDC, INC.. At the live price of $0.002/result + $0.0001/start, this first run costs at most $0.0021.

Input

Field	Type	Default	Meaning
query	string	blank	One legal-name search; used only if searchTerms and dosIds are empty
searchTerms	string[]	[]	Batch legal-name searches
dosIds	string[]	[]	Exact numeric NY DOS IDs
entityStatus	string	AllStatuses	Name-search filter: AllStatuses, Active, Inactive, or Suspended
entityTypes	string[]	[]	Optional categories: Corporation, LimitedLiabilityCompany, LimitedPartnership, LimitedLiabilityPartnership
searchMode	string	BeginsWith	Name matching: BeginsWith, Contains, or BaseWord
fetchDetails	boolean	true	Fetch service-of-process, principal/CEO, agent, stock, and additional filing fields
maxResults	integer	1	Total paid-record cap across the entire run, from 1 to 300

maxResults is not a per-term cap. Broad NY DOS name searches can report more matches than requested; the actor enforces the total cap before output and discloses the source's totalMatchingCount on each found row.

Exact DOS-ID lookup

{
  "dosIds": ["4381949"],
  "fetchDetails": true,
  "maxResults": 1
}

Active name search

{
  "query": "Goldman Sachs",
  "entityStatus": "Active",
  "searchMode": "BeginsWith",
  "fetchDetails": true,
  "maxResults": 10
}

Batch lookup

{
  "searchTerms": ["Goldman Sachs", "Morgan Stanley"],
  "entityStatus": "AllStatuses",
  "maxResults": 20
}

Output

A found row includes:

• setupStatus, official source, sourceUrl, sourceApiUrl, and UTC retrievedAt
• entityName, dosId, entityType, entityStatus, jurisdiction, filing date, county, and formation-law section
• service-of-process recipient/address
• principal executive or CEO fields when reported
• registered-agent fields when reported
• location, electronic-service, and stock/share fields when reported
• searchTerm, searchMode, source totalMatchingCount, run resultLimit, and detail-fetch evidence
• sourceWarnings and a mandatory evidenceNotice

Example:

{
  "setupStatus": "found",
  "source": "New York Department of State Division of Corporations Public Inquiry",
  "retrievedAt": "2026-07-26T04:36:02Z",
  "entityName": "GOLDMAN SACHS BDC, INC.",
  "dosId": "4381949",
  "entityType": "FOREIGN BUSINESS CORPORATION",
  "entityStatus": "Active",
  "jurisdiction": "Delaware, United States",
  "initialFilingDate": "2013-04-01T00:00:00",
  "effectiveFilingDate": "2013-04-01T00:00:00",
  "county": "New York",
  "sopName": "GOLDMAN SACHS BDC, INC.",
  "sopStreet": "200 WEST STREET",
  "sopCity": "NEW YORK",
  "sopState": "NY",
  "sopZip": "10282",
  "ceoName": "ALEX CHI AND DAVID MILLER, CO-CEOS",
  "principalOfficeStreet": "200 WEST STREET",
  "principalOfficeCity": "NEW YORK",
  "principalOfficeState": "NY",
  "principalOfficeZip": "10282",
  "searchTerm": "4381949",
  "searchMode": "dos_id",
  "totalMatchingCount": 1,
  "resultLimit": 1,
  "detailsRequested": true,
  "detailsFetched": true,
  "sourceWarnings": []
}

The actor also emits explicit paid evidence records for:

• no_match — a successful bounded search found no match
• invalid_input — supplied criteria failed validation
• source_unavailable — the official source could not complete the request after bounded retries

A failed detail request does not silently discard a valid basic search row. The basic row is preserved with detailsFetched: false and a warning.

Pricing

Component	Price
Actor start	$0.0001
Dataset record	$0.002

Examples:

Maximum returned records	Maximum charge
1	$0.0021
10	$0.0201
100	$0.2001

Buyer-defined Apify charge limits are enforced before source work/output. JSON, CSV, Excel, API, webhook, and Apify integration exports are available from the default dataset.

Reliability

• retries transport failures, response-body failures, malformed responses, HTTP 408/429, and 5xx statuses with bounded backoff;
• preserves basic rows if an individual detail call fails;
• deduplicates by DOS ID;
• validates DOS IDs, name length, status, match mode, and entity-type categories;
• returns explicit no-match and source-unavailable evidence instead of a misleading empty successful dataset.

Evidence and interpretation limits

This is point-in-time public-inquiry evidence, not a certified record or legal conclusion.

• A source-reported Active status does not by itself prove good standing, tax compliance, license compliance, beneficial ownership, authority, identity, solvency, or suitability.
• Filing addresses, registered agents, service recipients, officers, and principal fields can be incomplete, historical, corrected, or stale.
• Similar names require DOS-ID review. A name-search match is not identity verification.
• no_match is bounded to the supplied criteria, filters, result cap, and retrieval time. It does not prove an entity is unregistered, inactive, dissolved, or absent under another name or identifier.
• Obtain current certified records or status evidence from New York when legally authoritative proof is required.

Official source information: New York Department of State — Corporation and Business Entity Search Database.