# Washington SOS Business Search Scraper (`crawlerbros/washington-sos-scraper`) Actor Search Washington State's Corporations & Charities Filing System by business name, UBI number, or advanced filters. Returns entity status, registered agent, addresses, formation date, and governors. - **URL**: https://apify.com/crawlerbros/washington-sos-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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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 ## Washington SOS Business Search Scraper Scrape **Washington State's Corporations & Charities Filing System** (ccfs.sos.wa.gov) — the Secretary of State's official registry of businesses, nonprofits, and charities registered in Washington. Search by business name, UBI number, or a full set of advanced filters (business type, status, registered agent, governor, formation/expiration date). Returns entity status, registered agent details, principal office address, formation date, jurisdiction, and governors. No login required. ### What this actor does - **Three modes:** `byBusinessName`, `byUBINumber`, `advancedSearch` - **47 business/entity types** and **14 status values** available as filters, taken directly from the Secretary of State's own lookup lists - **Advanced search** by registered agent name, governor (officer/director/member) name, formation date range, expiration date, and nonprofit Federal EIN - **Optional detail enrichment** — pulls registered agent addresses, formation/expiration dates, jurisdiction, nature of business, nonprofit flags, and governors from each entity's full record - **Empty fields are omitted** — a field only appears on a record when the registry actually has a value for it ### Output per business - `businessName`, `dbaBusinessName` - `ubiNumber` — Washington's Unified Business Identifier - `businessType`, `businessTypeId` - `businessStatus` — e.g. `ACTIVE`, `DELINQUENT`, `TERMINATED` - `principalOfficeStreetAddress`, `principalOfficeMailingAddress` - `registeredAgentName`, `registeredAgentStreetAddress`, `registeredAgentMailingAddress` - `formationDate` — date of incorporation/formation/registration - `expirationDate` — period of duration, if not perpetual - `nextAnnualReportDueDate` - `inactiveDate` - `jurisdiction` — state/country of formation - `natureOfBusiness` — NAICS description (when on file) - `nonprofitEIN`, `isCharitableNonprofit`, `grossRevenueOver500k`, `hasMembers`, `isPublicBenefitNonprofit`, `isHostHomeRegistered` — nonprofit-only fields - `governors[]` — `{ name, title }` for each listed governor/officer - `businessId` — CCFS internal record ID - `sourceUrl` — deep link to the entity's page on ccfs.sos.wa.gov - `recordType: "business"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `byBusinessName` | `byBusinessName` / `byUBINumber` / `advancedSearch` | | `businessName` | string | – | Business name (mode=byBusinessName, required; optional filter in advancedSearch) | | `nameMatchType` | string | `Contains` | `Contains` / `StartsWith` / `ExactMatch` (mode=byBusinessName) | | `ubiNumber` | string | – | UBI number, e.g. `600413485` (mode=byUBINumber, required) | | `businessType` | string | – | One of 47 registered entity types (mode=advancedSearch) | | `businessStatus` | string | – | One of 14 status values (mode=advancedSearch) | | `registeredAgentName` | string | – | Registered agent name search (mode=advancedSearch) | | `governorName` | string | – | Governor/officer name search (mode=advancedSearch) | | `searchBy` | string | `Agent` | `Agent` or `Principal` — which of the two name fields above is used | | `formationDateFrom` / `formationDateTo` | string | – | Formation date range, `MM/DD/YYYY` (mode=advancedSearch) | | `expirationDate` | string | – | Expiration date, `MM/DD/YYYY` (mode=advancedSearch) | | `feinNumber` | string | – | Nonprofit's Federal EIN, e.g. `91-1234567` (mode=advancedSearch) | | `maxItems` | integer | `25` | Maximum number of business records to return (1–500) | | `fetchDetails` | boolean | `false` | Fetch full entity detail (agent addresses, dates, governors) per result. Slower and less predictable than the default summary-only search -- the registry re-verifies its anti-bot check on every detail page. Recommended only with small `maxItems`. | | `proxyConfiguration` | object | AUTO | Apify proxy configuration | #### Example: quick search by business name ```json { "mode": "byBusinessName", "businessName": "Microsoft", "maxItems": 10 } ```` #### Example: lookup by UBI number ```json { "mode": "byUBINumber", "ubiNumber": "600413485" } ``` #### Example: advanced search — active nonprofits formed since 2020 ```json { "mode": "advancedSearch", "businessType": "73", "businessStatus": "1", "formationDateFrom": "01/01/2020", "formationDateTo": "12/31/2026", "maxItems": 50 } ``` #### Example: search by registered agent, summary only (fast) ```json { "mode": "advancedSearch", "registeredAgentName": "Corporation Service Company", "searchBy": "Agent", "fetchDetails": false, "maxItems": 100 } ``` ### Use cases - **Compliance & KYC** — verify a Washington business is active and check its registered agent before signing a contract - **Sales & lead generation** — build prospect lists of newly formed businesses in a given entity type or date range - **Nonprofit research** — find charitable nonprofits registered in Washington and their governance details - **Legal & registered-agent services** — monitor entities represented by a specific registered agent - **Market research** — track business formation trends by entity type over time ### FAQ **Is this an official Washington Secretary of State product?** No. This is an independent, third-party actor that automates the same public search available at ccfs.sos.wa.gov. It is not affiliated with or endorsed by the Washington Secretary of State. **What is a UBI number?** The Unified Business Identifier is a 9-digit number Washington assigns to every registered business, used across state agencies (Secretary of State, Department of Revenue, Employment Security). **Why are some fields missing on a record?** Only fields the registry actually has data for are included. For example, `expirationDate` is omitted for entities with perpetual duration, and the nonprofit-specific fields only appear on nonprofit corporation types. **Can I search historical (pre-2004) filings?** No — CCFS only covers current electronic filings. Washington's Digital Archives (digitalarchives.wa.gov) hosts historical documents, which this actor does not scrape. **Does `fetchDetails=false` return less accurate data?** No — the summary fields (name, UBI, type, status, principal address, registered agent name) are exactly what the registry's own search results table shows. Enabling `fetchDetails` adds extra fields (dates, full addresses, governors) that require opening each entity's detail page, which takes longer. **How current is the data?** Every run queries the live registry directly, so results reflect the registry's current state at run time. **Are trademark or UCC filings included?** No — this actor covers business entity search only. CCFS also hosts separate trademark and charity-fundraiser search tools that are out of scope for this actor. ### Data Source & Reliability Notes ccfs.sos.wa.gov is a JavaScript single-page application protected by a Cloudflare Turnstile challenge on its search endpoints, which the registry re-verifies on every page (the initial search, each results page, and every detail page). This actor drives a real browser session to solve that challenge the same way a human visitor's browser does. The initial search is fast and highly reliable; because the site re-verifies on every subsequent page, enabling `fetchDetails` adds meaningfully more time per record and is best used with a small `maxItems`. On the rare run where a challenge cannot be resolved in time, the actor finishes cleanly with the records already collected (or zero, with a status message explaining why) rather than returning partial or fabricated data. # Actor input Schema ## `mode` (type: `string`): How to search the Washington business registry. ## `businessName` (type: `string`): Business name to search for, e.g. "Microsoft". Used with `mode=byBusinessName` (required) or as an optional filter in `advancedSearch`. ## `nameMatchType` (type: `string`): How `businessName` should be matched against registered entity names. ## `ubiNumber` (type: `string`): Washington Unified Business Identifier (UBI) number, e.g. "600413485" (Microsoft Corporation). Required for `mode=byUBINumber`. ## `businessType` (type: `string`): Filter results to a single registered business/entity type. ## `businessStatus` (type: `string`): Filter results to a single business/entity status. ## `registeredAgentName` (type: `string`): Search by registered agent name. Mutually exclusive with `governorName` (set `searchBy=Agent`). ## `governorName` (type: `string`): Search by governor (officer/director/member/manager) name. Mutually exclusive with `registeredAgentName` (set `searchBy=Principal`). ## `feinNumber` (type: `string`): Federal Employer Identification Number of a registered nonprofit corporation, e.g. "91-1234567". Matches the Secretary of State's own Advanced Search "Nonprofit EIN Provided" filter. ## `searchBy` (type: `string`): Whether `registeredAgentName` or `governorName` should be used for the person-name search in Advanced Search. ## `formationDateFrom` (type: `string`): Earliest date of incorporation/formation/registration, format MM/DD/YYYY. ## `formationDateTo` (type: `string`): Latest date of incorporation/formation/registration, format MM/DD/YYYY. ## `expirationDate` (type: `string`): Entity expiration date to filter on, format MM/DD/YYYY. ## `maxItems` (type: `integer`): Maximum number of business records to return. ## `fetchDetails` (type: `boolean`): When enabled, opens each search result's detail page to collect registered agent addresses, formation/expiration dates, and governors. This requires the site's anti-bot check to re-verify on every detail page, which can add significant time per record. When disabled (default), only the summary fields visible in the search results table are returned -- fast and highly reliable. ## `proxyConfiguration` (type: `object`): Washington's CCFS site is protected by a Cloudflare Turnstile challenge; Apify's free AUTO datacenter proxy group is used to render the page reliably. ## Actor input object example ```json { "mode": "byBusinessName", "businessName": "Microsoft", "nameMatchType": "Contains", "ubiNumber": "600413485", "searchBy": "Agent", "maxItems": 25, "fetchDetails": false, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `businesses` (type: `string`): Dataset containing all scraped Washington 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": "byBusinessName", "businessName": "Microsoft", "nameMatchType": "Contains", "ubiNumber": "600413485", "searchBy": "Agent", "maxItems": 25, "fetchDetails": false, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/washington-sos-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": "byBusinessName", "businessName": "Microsoft", "nameMatchType": "Contains", "ubiNumber": "600413485", "searchBy": "Agent", "maxItems": 25, "fetchDetails": False, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/washington-sos-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": "byBusinessName", "businessName": "Microsoft", "nameMatchType": "Contains", "ubiNumber": "600413485", "searchBy": "Agent", "maxItems": 25, "fetchDetails": false, "proxyConfiguration": { "useApifyProxy": true } }' | apify call crawlerbros/washington-sos-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/washington-sos-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Washington SOS Business Search Scraper", "description": "Search Washington State's Corporations & Charities Filing System by business name, UBI number, or advanced filters. Returns entity status, registered agent, addresses, formation date, and governors.", "version": "1.0", "x-build-id": "tutsuPcBi2G0woczs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~washington-sos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-washington-sos-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~washington-sos-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-washington-sos-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~washington-sos-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-washington-sos-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" ], "properties": { "mode": { "title": "Search mode", "enum": [ "byBusinessName", "byUBINumber", "advancedSearch" ], "type": "string", "description": "How to search the Washington business registry.", "default": "byBusinessName" }, "businessName": { "title": "Business name (mode=byBusinessName, advancedSearch)", "type": "string", "description": "Business name to search for, e.g. \"Microsoft\". Used with `mode=byBusinessName` (required) or as an optional filter in `advancedSearch`." }, "nameMatchType": { "title": "Name match type (mode=byBusinessName)", "enum": [ "Contains", "StartsWith", "ExactMatch" ], "type": "string", "description": "How `businessName` should be matched against registered entity names.", "default": "Contains" }, "ubiNumber": { "title": "UBI number (mode=byUBINumber)", "type": "string", "description": "Washington Unified Business Identifier (UBI) number, e.g. \"600413485\" (Microsoft Corporation). Required for `mode=byUBINumber`." }, "businessType": { "title": "Business type (mode=advancedSearch)", "enum": [ "14", "15", "16", "17", "19", "20", "21", "22", "23", "24", "25", "26", "27", "33", "35", "37", "38", "39", "40", "43", "44", "54", "55", "56", "57", "58", "59", "60", "61", "62", "63", "64", "65", "67", "68", "69", "71", "72", "73", "74", "76", "79", "85", "86", "88", "89", "90" ], "type": "string", "description": "Filter results to a single registered business/entity type." }, "businessStatus": { "title": "Business status (mode=advancedSearch)", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "15" ], "type": "string", "description": "Filter results to a single business/entity status." }, "registeredAgentName": { "title": "Registered agent name (mode=advancedSearch)", "type": "string", "description": "Search by registered agent name. Mutually exclusive with `governorName` (set `searchBy=Agent`)." }, "governorName": { "title": "Governor name (mode=advancedSearch)", "type": "string", "description": "Search by governor (officer/director/member/manager) name. Mutually exclusive with `registeredAgentName` (set `searchBy=Principal`)." }, "feinNumber": { "title": "Nonprofit Federal EIN (mode=advancedSearch)", "type": "string", "description": "Federal Employer Identification Number of a registered nonprofit corporation, e.g. \"91-1234567\". Matches the Secretary of State's own Advanced Search \"Nonprofit EIN Provided\" filter." }, "searchBy": { "title": "Person search target (mode=advancedSearch)", "enum": [ "Agent", "Principal" ], "type": "string", "description": "Whether `registeredAgentName` or `governorName` should be used for the person-name search in Advanced Search.", "default": "Agent" }, "formationDateFrom": { "title": "Formation date from (mode=advancedSearch)", "type": "string", "description": "Earliest date of incorporation/formation/registration, format MM/DD/YYYY." }, "formationDateTo": { "title": "Formation date to (mode=advancedSearch)", "type": "string", "description": "Latest date of incorporation/formation/registration, format MM/DD/YYYY." }, "expirationDate": { "title": "Expiration date (mode=advancedSearch)", "type": "string", "description": "Entity expiration date to filter on, format MM/DD/YYYY." }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of business records to return.", "default": 25 }, "fetchDetails": { "title": "Fetch full entity details (slower)", "type": "boolean", "description": "When enabled, opens each search result's detail page to collect registered agent addresses, formation/expiration dates, and governors. This requires the site's anti-bot check to re-verify on every detail page, which can add significant time per record. When disabled (default), only the summary fields visible in the search results table are returned -- fast and highly reliable.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Washington's CCFS site is protected by a Cloudflare Turnstile challenge; Apify's free AUTO datacenter proxy group is used to render the page reliably.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```