# US Unclaimed Property Scraper (`crawlerbros/us-unclaimed-property-scraper`) Actor Search unclaimed money and uncashed checks held by US government treasuries across multiple states (CA, MD, MA, MN, RI, TX). Search by owner name or browse by state -- amount, holder, property type, and dates included. - **URL**: https://apify.com/crawlerbros/us-unclaimed-property-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Agents, Lead generation - **Stats:** 2 total users, 0 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 ## US Unclaimed Property Scraper Search unclaimed money and uncashed checks held by US government treasuries across multiple states — search by owner/payee name or browse a state's register. Amounts, holder (the government body holding the money), property type, and dates included wherever the source discloses them. Pure HTTP, no auth, no proxy, no CAPTCHA. ### What this actor does - **Two modes:** `search` (owner name) and `browse` (list a state's register) - **6 states covered, 9 government sources:** California, Maryland, Massachusetts, Minnesota, Rhode Island, Texas - **Multi-state in one run** — set `state` to `ALL` to search every source at once - **Jurisdiction filter** — narrow to one specific government source (useful when a state has more than one, e.g. California or Massachusetts) - **Sorting** — highest/lowest amount, most/least recent, or source order - **Minimum- and maximum-amount filters** to bracket a balance range - **Empty fields are omitted** — a source is never forced to report a field it doesn't disclose ### Data source This actor aggregates **public, unauthenticated Socrata (SODA) open-data APIs** published directly by 9 US county/city treasuries as their official unclaimed-funds / uncashed-check registers: | State | Jurisdiction | Property type | |---|---|---| | California | Marin County | Uncashed county checks | | California | City of Roseville | Stale-dated municipal checks | | Maryland | Montgomery County | Unclaimed vendor payments | | Massachusetts | Town of Framingham | Unclaimed payroll checks | | Massachusetts | Town of Framingham | Unclaimed resident/vendor/AP checks | | Minnesota | Ramsey County | Unclaimed money | | Rhode Island | City of Providence | Uncashed municipal checks | | Texas | City of Austin | Unclaimed property | | Texas | City of Corpus Christi | Unclaimed property | **Why not a state-level Treasury / MissingMoney.com?** We researched this thoroughly before building. The obvious "one-stop" target — MissingMoney.com, the NAUPA-endorsed multi-state search — is blocked behind three layered anti-bot systems (a Cloudflare Turnstile challenge injected into every page, AWS WAF Bot Control 403s, and a `__cf_bm` bot-detection cookie); this holds for plain HTTP clients, TLS-impersonating clients, and full headless browsers alike. The same problem exists further down the list: FDIC's national unclaimed-funds search requires a validated Google reCAPTCHA token; PBGC's pension search requires the claimant's own Social Security number; Texas's own state-level open-data unclaimed-property dataset returns `403` to anonymous requests and requires emailing the Comptroller's office for an access grant. In short, **every state's live name-search portal is CAPTCHA/WAF-gated** — that's exactly why third-party "finder" sites merely deep-link into those portals instead of scraping them. What *is* reliably open is the layer beneath the search UI: many county and city treasuries publish their own unclaimed-funds ledgers as public Socrata datasets with anonymous API access (no key, no login, no CAPTCHA) — the same open-data infrastructure many US cities use for budgets, permits, and 311 data. This actor aggregates 9 such datasets across 6 states into a single multi-state search/browse tool. It complements, and does not duplicate, this repo's `CAUnclaimedPropertyScraper` (which is single-state, sourced from the California State Controller's own bulk CSV export of its statewide database — a different tier of source entirely). ### Output per record | Field | Description | |---|---| | `ownerName` | Owner/payee name on the unclaimed funds | | `amountUsd` | Dollar amount, where the source discloses one | | `reportedDate` | Check/transaction date (`YYYY-MM-DD`), where disclosed | | `address` | Last-known street address, where disclosed (joins multi-line addresses, e.g. Providence's suite/floor lines, into one string) | | `city` | City, where disclosed | | `postalCode` | ZIP code, where disclosed | | `recordId` | Source's own record/check ID, where disclosed | | `vendorId` | Source's own vendor/payee ID, where disclosed — currently only Montgomery County, MD | | `invoiceDate` | Underlying invoice date (`YYYY-MM-DD`), where disclosed separately from `reportedDate` — currently only Montgomery County, MD | | `state` | 2-letter state code | | `jurisdiction` | The specific county/city government holding the funds | | `holderName` | Same as `jurisdiction` — the entity holding the money | | `propertyType` | Category, e.g. "Unclaimed Vendor Payment (County)" | | `paymentStatus` | Bank/ERP status of the payment (e.g. "Negotiable", "Void"), where disclosed — currently only Montgomery County, MD | | `sourceUrl` | The government's own open-data page for this dataset | | `recordType` | Always `"unclaimedProperty"` | | `scrapedAt` | UTC timestamp of the scrape | Not every jurisdiction discloses every field — e.g. the City of Austin's dataset lists owner names only, with no amount or date. Fields that aren't disclosed are simply omitted, never faked. ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | select | `search` | `search` (by owner name) or `browse` (no name filter) | | `state` | select | `MN` | `ALL`, `CA`, `MA`, `MD`, `MN`, `RI`, or `TX` | | `jurisdiction` | select | `ALL` | Narrow to one specific government source's dataset (e.g. just Marin County, not all of CA) | | `ownerName` | string | `Johnson` | Required for `mode=search`; case-insensitive substring match | | `minAmountUsd` | int | `0` | Only include records at least this large (where amount is disclosed) | | `maxAmountUsd` | int | unset | Only include records at most this large (where amount is disclosed) | | `sortBy` | select | `amountDesc` | `amountDesc` / `amountAsc` / `dateDesc` / `dateAsc` / `relevance` | | `maxItems` | int | `20` | Hard cap on emitted records (1–1000) | #### Example: search by name across all states ```json { "mode": "search", "state": "ALL", "ownerName": "Smith", "maxItems": 50 } ```` #### Example: browse California's highest-value unclaimed funds ```json { "mode": "browse", "state": "CA", "sortBy": "amountDesc", "minAmountUsd": 1000, "maxItems": 100 } ``` #### Example: recent unclaimed payroll checks in Massachusetts ```json { "mode": "browse", "state": "MA", "sortBy": "dateDesc", "maxItems": 25 } ``` ### Use cases - **Asset-recovery researchers** — screen multiple states' unclaimed-funds ledgers by name in one run - **Genealogy / heir-search firms** — sweep county-level registers for a family surname - **Finance / fraud investigators** — cross-reference vendor payment records with known entities - **Local journalism** — surface large uncashed municipal payments for public-interest reporting - **Personal finance tools** — let users check multiple jurisdictions for money owed to them ### FAQ **Does this cover my state's full unclaimed-property database?** No — this actor covers county/city government ledgers that publish open Socrata data, not each state's complete Treasury database (those require going through the state's own CAPTCHA-protected search, which this project does not bypass). For California specifically, see this repo's separate `CAUnclaimedPropertyScraper`, sourced from the CA State Controller's full statewide bulk CSV export. **Why is `amountUsd` missing on some records?** The source jurisdiction (currently only the City of Austin, TX) publishes owner names without a disclosed dollar amount. We never fabricate a placeholder value — the field is simply omitted. **What does `paymentStatus` mean?** Montgomery County, MD is the only jurisdiction that discloses this — it's the bank/ERP status of the payment (e.g. "Negotiable" means the check can still be cashed; "Void" or "Reconciled" means it can't). No other source in this actor publishes an equivalent field. **How do I claim money I find?** This actor surfaces public record data only; it does not file claims. Contact the `jurisdiction`/`holderName` government office directly, or visit the `sourceUrl` dataset page for the office's own contact information. **How often is the underlying data refreshed?** Each government body refreshes its own Socrata dataset on its own schedule (typically daily-to-monthly); the actor always queries the live API, so results reflect whatever is currently published. **Can I search all 6 states in a single run?** Yes — set `state` to `ALL`; the actor queries all 9 sources concurrently and merges/sorts the results. # Actor input Schema ## `mode` (type: `string`): search: find records by owner name. browse: list a state's register without a name filter. ## `state` (type: `string`): Which state's unclaimed-property source(s) to query. 'All states' fans out to every supported source in one run. ## `jurisdiction` (type: `string`): Narrow to one specific government source's dataset (useful when a state has more than one, e.g. California or Massachusetts). 'All jurisdictions' queries every source in the selected state(s). ## `ownerName` (type: `string`): Full or partial owner/payee name to search for (case-insensitive substring match), e.g. `Johnson` or `Smith LLC`. ## `minAmountUsd` (type: `integer`): Only include records worth at least this much (where the source discloses an amount). 0 = no minimum. ## `maxAmountUsd` (type: `integer`): Only include records worth at most this much (where the source discloses an amount). Leave unset for no maximum. ## `sortBy` (type: `string`): How to order results. Falls back to whatever field a jurisdiction actually provides. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## Actor input object example ```json { "mode": "search", "state": "MN", "jurisdiction": "ALL", "ownerName": "Johnson", "minAmountUsd": 0, "sortBy": "amountDesc", "maxItems": 20 } ``` # Actor output Schema ## `unclaimedProperty` (type: `string`): Dataset containing all scraped unclaimed-property 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": "search", "state": "MN", "jurisdiction": "ALL", "ownerName": "Johnson", "minAmountUsd": 0, "sortBy": "amountDesc", "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/us-unclaimed-property-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": "search", "state": "MN", "jurisdiction": "ALL", "ownerName": "Johnson", "minAmountUsd": 0, "sortBy": "amountDesc", "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/us-unclaimed-property-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": "search", "state": "MN", "jurisdiction": "ALL", "ownerName": "Johnson", "minAmountUsd": 0, "sortBy": "amountDesc", "maxItems": 20 }' | apify call crawlerbros/us-unclaimed-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/us-unclaimed-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "US Unclaimed Property Scraper", "description": "Search unclaimed money and uncashed checks held by US government treasuries across multiple states (CA, MD, MA, MN, RI, TX). Search by owner name or browse by state -- amount, holder, property type, and dates included.", "version": "1.0", "x-build-id": "Ij9t0IIyDQUzmDapZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~us-unclaimed-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-us-unclaimed-property-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~us-unclaimed-property-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-us-unclaimed-property-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~us-unclaimed-property-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-us-unclaimed-property-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", "state" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "browse" ], "type": "string", "description": "search: find records by owner name. browse: list a state's register without a name filter.", "default": "search" }, "state": { "title": "State", "enum": [ "ALL", "CA", "MA", "MD", "MN", "RI", "TX" ], "type": "string", "description": "Which state's unclaimed-property source(s) to query. 'All states' fans out to every supported source in one run.", "default": "MN" }, "jurisdiction": { "title": "Jurisdiction", "enum": [ "ALL", "tx_austin", "tx_corpuschristi", "ri_providence", "ca_marin", "ca_roseville", "md_montgomery", "mn_ramsey", "ma_framingham_payroll", "ma_framingham_vendor" ], "type": "string", "description": "Narrow to one specific government source's dataset (useful when a state has more than one, e.g. California or Massachusetts). 'All jurisdictions' queries every source in the selected state(s).", "default": "ALL" }, "ownerName": { "title": "Owner name (mode=search)", "type": "string", "description": "Full or partial owner/payee name to search for (case-insensitive substring match), e.g. `Johnson` or `Smith LLC`.", "default": "Johnson" }, "minAmountUsd": { "title": "Minimum amount (USD)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only include records worth at least this much (where the source discloses an amount). 0 = no minimum.", "default": 0 }, "maxAmountUsd": { "title": "Maximum amount (USD)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Only include records worth at most this much (where the source discloses an amount). Leave unset for no maximum." }, "sortBy": { "title": "Sort by", "enum": [ "amountDesc", "amountAsc", "dateDesc", "dateAsc", "relevance" ], "type": "string", "description": "How to order results. Falls back to whatever field a jurisdiction actually provides.", "default": "amountDesc" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 20 } } }, "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 } } } } } } } } } } ```