US Business Entity Lookup - Apify Actor

Look up business entity records from US state Secretary of State databases. Returns structured data including business name, status, formation date, entity type, registered agent, and principal office address.

Currently Supported States

• Colorado (CO) — Colorado Secretary of State Business Database

Input

{
  "searchQuery": "Acme Corp",
  "state": "CO",
  "maxResults": 5
}

Or look up by entity number directly:

{
  "entityNumber": "20241648974",
  "state": "CO"
}

Input Parameters

Parameter	Type	Required	Description
searchQuery	string	Yes*	Business name to search for
entityNumber	string	Yes*	Direct entity/file number lookup
state	string	No	US state code (default: CO)
maxResults	integer	No	Max results to return (default: 5, max: 20)

*One of searchQuery or entityNumber is required.

Output

Each result contains:

{
  "name": "ACME ROOFING COMPANY LLC",
  "entityId": "20241648974",
  "status": "Delinquent",
  "formationDate": "06/19/2024",
  "entityType": "Limited Liability Company",
  "periodicReportMonth": "June",
  "jurisdiction": "Colorado",
  "principalStreetAddress": "5080 Uvalda St, Denver, CO 80239, US",
  "principalMailingAddress": "5080 Uvalda St, Denver, CO 80239, US",
  "registeredAgent": {
    "name": "Jorge Alberto Romero Sr.",
    "streetAddress": "5080 Uvalda St, Denver, CO 80239, US",
    "mailingAddress": "5080 Uvalda St, Denver, CO 80239, US"
  },
  "state": "CO",
  "source": "Colorado Secretary of State",
  "sourceUrl": "https://www.sos.state.co.us/biz/BusinessEntityDetail.do?masterFileId=20241648974"
}

MCP Server

This actor also includes an MCP (Model Context Protocol) server definition in mcp.json. The tool business_entity_lookup can be used by AI agents to look up business entities programmatically.

Rate Limiting

The Colorado SOS website uses Cloudflare protection. The scraper includes:

• Realistic browser headers
• Delays between requests (300-500ms)
• Session cookie management
• Cloudflare detection and error reporting

Avoid making more than ~10-20 requests per minute to prevent being temporarily blocked.

Development

npm install
npm test      # Run test queries
npm start     # Run as Apify actor (needs Apify SDK)

Adding More States

To add a new state, create a new scraper module in src/states/ following the Colorado pattern. Each state scraper should export searchByName() and getEntityDetail() functions.

License

MIT