# Colorado Secretary of State Business Search Scraper (`crawlerbros/colorado-sos-business-search-scraper`) Actor Search Colorado's official business entity registry by entity name, entity ID, registered agent name, or principal city. Get entity type, status, formation date, jurisdiction, address, and registered agent details. - **URL**: https://apify.com/crawlerbros/colorado-sos-business-search-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Agents, Automation, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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 ## Colorado Secretary of State Business Search Scraper Search **Colorado's official business entity registry**, published by the Colorado Secretary of State on the state's own open-data portal (`data.colorado.gov`). Look up a business by entity name, exact entity ID, registered agent name, or principal city, and get entity type, status, formation date, jurisdiction of formation, principal/mailing address, and registered agent details. HTTP-only via Colorado's public open-data API — no login required. ### Data Source & Usage Notes **Read this before running a large job.** - **No login, no API key, no CAPTCHA.** The source is Colorado's public Socrata open-data API (`data.colorado.gov/resource/4ykn-tg5h.json`), the same underlying Secretary of State record set that powers the interactive search at `coloradosos.gov/biz`. - **Why the open-data API instead of `coloradosos.gov/biz` directly?** Confirmed live: both `www.sos.state.co.us` and `coloradosos.gov` sit behind a Cloudflare managed challenge (a JS-execution bot check) that returns a 403 "Attention Required" page to any non-browser request regardless of User-Agent. Colorado's own Secretary of State publishes the identical business-entity dataset, updated regularly, on the state's official open-data portal with no such challenge — this actor queries that official mirror directly. - **`jurisdictionOfFormation` is free text, not a normalized code.** Filers enter this field themselves on the source's own filings, so values range from `CO` / `Colorado` to full state names, countries, county names, and occasional stray addresses or dates. The filter is a case-insensitive substring match, not an enum. - **No individual-officer or filing-number search axis.** The open-data extract carries entity-level and registered-agent fields only; it does not include the interactive site's officer/director listing or filing history, so those are not exposed here. - **Conservative by design.** The actor only ever uses Apify's free datacenter (AUTO) proxy group — never a paid residential proxy — to get a fresh IP if a request is ever blocked. - **Not affiliated with the State of Colorado.** This is an independent third-party tool using the Secretary of State's own public, no-login open-data API. #### Why Colorado's open-data API instead of the interactive search site? This actor was originally scoped to scrape `sos.state.co.us` directly. Live verification showed that domain (and its `coloradosos.gov` alias) return a Cloudflare managed-challenge 403 to all non-browser HTTP traffic, including Apify's own datacenter proxy IPs — a genuine block per this project's zero-cost reliability policy. Rather than replace the target state entirely, this actor uses the Colorado Secretary of State's own official open-data republication of the exact same business-entity registry (`data.colorado.gov`), confirmed live and returning real, current data with no CAPTCHA or challenge of any kind. ### What this actor does - **4 search modes**: - `byEntityName` — business entity name (substring match) - `byEntityId` — exact Colorado Secretary of State entity ID - `byAgentName` — registered agent individual or organization name (substring match) - `byCity` — principal-office city (exact match) - **Entity status filter** — 15 status values (`Good Standing`, `Delinquent`, `Administratively Dissolved`, etc.) - **Entity type filter** — 33 entity type codes (LLC, corporation, nonprofit, partnership, trust, etc.) - **Jurisdiction of formation filter** — substring match against the filer-entered jurisdiction text - **Principal address state filter** — exact match against the entity's principal-office US state/territory - **Formation date range filter** — `formationDateFrom` / `formationDateTo` (`YYYY-MM-DD`) - **Automatic pagination** up to `maxItems` (the open-data API supports offset-based paging past the 1,000-row single-page limit) - **Empty fields are omitted** ### What's NOT included (and why) - **Individual officer/director names** — not present in the open-data extract; the interactive site's officer listing is a separate, non-open-data feature. - **Filing history / document list** — not present in the open-data extract. - **NAICS industry code** — not present in this dataset (unlike some other states' registries). - **A normalized jurisdiction code** — see "Data Source & Usage Notes" above; `jurisdictionOfFormation` is filer-entered free text. ### Output per entity - `entityName` - `entityId` — Colorado Secretary of State entity ID number - `entityType` — human-readable, e.g. `Domestic Limited Liability Company` - `entityTypeCode` — raw source code, e.g. `DLLC` - `status` — e.g. `Good Standing`, `Delinquent` - `jurisdictionOfFormation` — filer-entered text, e.g. `DE`, `Colorado` - `formationDate` — `YYYY-MM-DD` - `principalAddress`, `principalCity`, `principalState`, `principalZip` - `mailingAddress` — when on file - `registeredAgentName` (includes filer-entered suffix, e.g. `John Smith, Jr.`), `registeredAgentAddress` (agent's principal/street address), `registeredAgentMailingAddress` (agent's mailing address, when on file and different from the principal address) - `sourceUrl` — link to this entity's record on Colorado's open-data API - `recordType: "entity"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `byEntityName` | One of the 4 search modes | | `entityName` | string | `WALMART` | mode=byEntityName | | `entityId` | string | – | mode=byEntityId | | `agentName` | string | – | mode=byAgentName | | `principalCity` | string | – | mode=byCity | | `entityStatus` | string | any | Optional status filter | | `entityType` | string | any | Optional entity type filter | | `jurisdictionOfFormation` | string | – | Optional substring filter | | `principalState` | string | any | Optional exact-match principal-office state/territory filter | | `formationDateFrom` | string | – | Optional `YYYY-MM-DD` lower bound on formation date | | `formationDateTo` | string | – | Optional `YYYY-MM-DD` upper bound on formation date | | `proxyConfiguration` | object | AUTO proxy | Apify proxy config; always datacenter (AUTO), never residential | | `maxItems` | int | `25` | Hard cap (1–1000) | #### Example: search by entity name ```json { "mode": "byEntityName", "entityName": "TESLA", "maxItems": 10 } ```` #### Example: lookup by exact entity ID ```json { "mode": "byEntityId", "entityId": "19871633113" } ``` #### Example: search by registered agent ```json { "mode": "byAgentName", "agentName": "CT CORPORATION SYSTEM", "maxItems": 25 } ``` #### Example: browse by principal city and status ```json { "mode": "byCity", "principalCity": "Denver", "entityStatus": "Good Standing", "entityType": "DLLC", "maxItems": 50 } ``` ### Use cases - **Due diligence** — confirm a counterparty's Colorado formation date, entity type, and registered agent before contracting - **Compliance & KYC** — cross-check a business's legal entity name and entity ID - **Registered agent research** — find every entity a specific agent represents - **Local market research** — pull every active entity in a given city - **Company name availability checks** — see what similarly-named entities already exist before choosing a new name ### FAQ **What's the data source?** The Colorado Secretary of State's own business-entity registry, published on the state's official open-data portal at `data.colorado.gov`. This actor is an independent third-party tool and is not affiliated with the State of Colorado. **Is this data official / legally binding?** No. For an official Certificate of Good Standing or certified copies, use the state's paid ordering channels via `coloradosos.gov`. This actor returns the same free, public informational data the state republishes as open data. **Why did my run return 0 results?** Either the query genuinely has no match, or a status/type/jurisdiction filter is narrower than expected. Try a broader query or remove a filter. **How fresh is the data?** The open-data extract is refreshed regularly by the Colorado Secretary of State (typically daily); it may lag the live interactive site by up to a day. **Can I search inactive/dissolved businesses?** Yes — set `entityStatus` to any of the 15 available values, including `Administratively Dissolved`, `Voluntarily Dissolved`, `Revoked`, and `Withdrawn`. **Can I filter by principal-office state or formation date?** Yes — `principalState` narrows results to a single US state/territory, and `formationDateFrom` / `formationDateTo` narrow results to a formation-date range. Both combine with any search mode and any other filter. # Actor input Schema ## `mode` (type: `string`): Which search axis to use. ## `entityName` (type: `string`): Business entity name to search for (substring match), e.g. `WALMART`. ## `entityId` (type: `string`): Exact Colorado Secretary of State entity ID number, e.g. `19871633113`. ## `agentName` (type: `string`): Registered agent individual or organization name to search for (substring match), e.g. `CT CORPORATION SYSTEM`. ## `principalCity` (type: `string`): Exact principal-office city to browse entities in, e.g. `Denver`. ## `entityStatus` (type: `string`): Optionally restrict results to a single entity status. ## `entityType` (type: `string`): Optionally restrict results to a single entity type. ## `jurisdictionOfFormation` (type: `string`): Optionally restrict results to entities whose filer-entered jurisdiction of formation contains this text, e.g. `Delaware`. Free text (not a normalized code) -- see README. ## `principalState` (type: `string`): Optionally restrict results to entities whose principal-office state/territory matches exactly, e.g. `CO`. ## `formationDateFrom` (type: `string`): Optionally restrict results to entities formed on or after this date. ## `formationDateTo` (type: `string`): Optionally restrict results to entities formed on or before this date. ## `proxyConfiguration` (type: `object`): Uses Apify's free datacenter (AUTO) proxy group to get a fresh IP if a request is temporarily blocked. Residential proxy is never used by this actor. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## Actor input object example ```json { "mode": "byEntityName", "entityName": "WALMART", "entityStatus": "", "entityType": "", "principalState": "", "proxyConfiguration": { "useApifyProxy": true }, "maxItems": 10 } ``` # Actor output Schema ## `entities` (type: `string`): Dataset containing all scraped Colorado business entity records. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "byEntityName", "entityName": "WALMART", "entityStatus": "", "entityType": "", "principalState": "", "proxyConfiguration": { "useApifyProxy": true }, "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/colorado-sos-business-search-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "byEntityName", "entityName": "WALMART", "entityStatus": "", "entityType": "", "principalState": "", "proxyConfiguration": { "useApifyProxy": True }, "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/colorado-sos-business-search-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 '{ "mode": "byEntityName", "entityName": "WALMART", "entityStatus": "", "entityType": "", "principalState": "", "proxyConfiguration": { "useApifyProxy": true }, "maxItems": 10 }' | apify call crawlerbros/colorado-sos-business-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/colorado-sos-business-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Colorado Secretary of State Business Search Scraper", "description": "Search Colorado's official business entity registry by entity name, entity ID, registered agent name, or principal city. Get entity type, status, formation date, jurisdiction, address, and registered agent details.", "version": "1.0", "x-build-id": "PYQUhpyeqeEWasAhh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~colorado-sos-business-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-colorado-sos-business-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~colorado-sos-business-search-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-colorado-sos-business-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~colorado-sos-business-search-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-colorado-sos-business-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode", "proxyConfiguration" ], "properties": { "mode": { "title": "Search mode", "enum": [ "byEntityName", "byEntityId", "byAgentName", "byCity" ], "type": "string", "description": "Which search axis to use.", "default": "byEntityName" }, "entityName": { "title": "Entity name (mode=byEntityName)", "type": "string", "description": "Business entity name to search for (substring match), e.g. `WALMART`.", "default": "WALMART" }, "entityId": { "title": "Entity ID (mode=byEntityId)", "type": "string", "description": "Exact Colorado Secretary of State entity ID number, e.g. `19871633113`." }, "agentName": { "title": "Registered agent name (mode=byAgentName)", "type": "string", "description": "Registered agent individual or organization name to search for (substring match), e.g. `CT CORPORATION SYSTEM`." }, "principalCity": { "title": "Principal city (mode=byCity)", "type": "string", "description": "Exact principal-office city to browse entities in, e.g. `Denver`." }, "entityStatus": { "title": "Entity status filter", "enum": [ "", "Good Standing", "Exists", "Delinquent", "Noncompliant", "Administratively Dissolved", "Voluntarily Dissolved", "Judicially Dissolved", "Dissolved (Term Expired)", "Revoked", "Withdrawn", "Merged", "Consolidated", "Converted", "Registered Agent Resigned", "Effectiveness Prevented" ], "type": "string", "description": "Optionally restrict results to a single entity status.", "default": "" }, "entityType": { "title": "Entity type filter", "enum": [ "", "DLLC", "FLLC", "DPC", "FPC", "DNC", "FNC", "DLP", "FLP", "DLLP", "FLLP", "DLLLP", "FLLLP", "GP", "SP", "CU", "CS", "DC55", "DC55-PBC", "DC56", "DC56-PBC", "DLCA", "DLCA-PBC", "DLPA", "FLPA", "DPC-PBC", "DT", "FCOOP", "FLCA", "FO", "IC", "SL", "UNA", "WC" ], "type": "string", "description": "Optionally restrict results to a single entity type.", "default": "" }, "jurisdictionOfFormation": { "title": "Jurisdiction of formation filter", "type": "string", "description": "Optionally restrict results to entities whose filer-entered jurisdiction of formation contains this text, e.g. `Delaware`. Free text (not a normalized code) -- see README." }, "principalState": { "title": "Principal address state filter", "enum": [ "", "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "GU", "MP", "PR", "VI" ], "type": "string", "description": "Optionally restrict results to entities whose principal-office state/territory matches exactly, e.g. `CO`.", "default": "" }, "formationDateFrom": { "title": "Formation date from (YYYY-MM-DD)", "type": "string", "description": "Optionally restrict results to entities formed on or after this date." }, "formationDateTo": { "title": "Formation date to (YYYY-MM-DD)", "type": "string", "description": "Optionally restrict results to entities formed on or before this date." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Uses Apify's free datacenter (AUTO) proxy group to get a fresh IP if a request is temporarily blocked. Residential proxy is never used by this actor.", "default": { "useApifyProxy": true } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 25 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```