# California Unclaimed Property Scraper (`crawlerbros/ca-unclaimed-property-scraper`) Actor

Search California's official Unclaimed Property database (State Controller's Office) by owner name, city, or holder business. Browse by value range. Free, no login, sourced from the SCO's public weekly data files.

- **URL**: https://apify.com/crawlerbros/ca-unclaimed-property-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Automation, Developer tools, Agents
- **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.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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

## California Unclaimed Property Scraper

Search **California's official Unclaimed Property database**, maintained by the California State Controller's Office (SCO). Look up unclaimed cash, uncashed checks, dormant accounts, and unclaimed securities by owner name, or browse by dollar-value range, city, or the business that reported the property. The SCO currently holds more than $8 billion in unclaimed property for millions of individuals and businesses. No login, no API key, no paid proxy.

### What this actor does

- **Three modes:** `search` (by owner name), `browse` (filter without a name), and `byId` (exact lookup of one property by its Property ID — also returns every co-owner row for that property)
- **Filters:** owner city/state/ZIP/country, holder (reporting business) name/city/state, property-type keyword, property category (top-level NAUPA grouping), CUSIP (security identifier), cash-balance range, and dollar-value bucket
- **Sorting:** rank results by highest/lowest current cash balance or owner name A-Z/Z-A, keeping the top `maxItems`
- **Full financial detail:** current cash balance, cash/shares originally reported, security name, claim counts
- **Owner and holder contact info:** name, address, city, state, ZIP, country for the property owner and the business that reported it
- **Deduplicated results** — the SCO's own source files occasionally contain exact-duplicate rows; this actor automatically filters them out so you never see the same property/owner combination twice (legitimate co-owner rows on the same property are kept, since those describe different people)
- **Empty fields are omitted** — every field present in a record has a real value

### Output per unclaimed-property record

- `propertyId` — the SCO's internal property identifier
- `propertyType` — NAUPA property-type code and description (e.g. `securities`, `wages`, `safe deposit box contents`)
- `ownerName`, `ownerAddress`, `ownerCity`, `ownerState`, `ownerZip`, `ownerCountry`
- `numberOfOwners` — number of owners on record (some properties are jointly owned)
- `cashReported`, `sharesReported`, `securityName` — the amount/security originally reported to the state
- `currentCashBalance` — current dollar value held by the state
- `pendingClaims`, `paidClaims` — how many claims have been filed / paid against this property
- `holderName`, `holderAddress`, `holderCity`, `holderState`, `holderZip` — the business/entity that reported the property
- `cusip` — security identifier, when the property is a stock/bond
- `valueRangeBucket` — which value bucket this record came from
- `sourceFile` — the specific source CSV file the record was read from
- `sourceUrl` — the official California claim-search page
- `recordType: "unclaimedProperty"`, `scrapedAt`

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | `search` (owner name required), `browse` (no name required), or `byId` (propertyId required) |
| `ownerName` | string | `Smith` | Owner name to search for (mode=search); case-insensitive substring match |
| `propertyId` | string | – | Exact Property ID to look up (mode=byId); returns every co-owner row for that property |
| `ownerCity` | string | – | Only keep records whose owner city contains this text |
| `ownerState` | string | – | Only keep records with this exact owner state (2-letter code) |
| `ownerZip` | string | – | Only keep records whose owner ZIP starts with this value (`94105` or a shorter prefix like `941`) |
| `ownerCountry` | string | – | Only keep records whose owner country code contains this text (e.g. `USA`, `CAN`, `MEX`) |
| `holderName` | string | – | Only keep records whose reporting business ("holder") contains this text |
| `holderCity` | string | – | Only keep records whose holder city contains this text |
| `holderState` | string | – | Only keep records with this exact holder state (2-letter code) |
| `propertyTypeContains` | string | – | Only keep records whose property-type text contains this keyword |
| `propertyCategory` | string | – | Only keep records in this top-level NAUPA category (Accounts, Checks, Securities, Insurance, etc.) |
| `cusip` | string | – | Only keep records with this exact security identifier (CUSIP) |
| `minCashBalance` | int | – | Drop records below this current cash balance (USD) |
| `maxCashBalance` | int | – | Drop records above this current cash balance (USD) |
| `valueRange` | string | `500plus` | Which value-bucket file(s) to scan: `500plus`, `100to500`, `10to100`, `under10`, or `all` |
| `sortBy` | string | `none` | Rank kept records: `none` (fastest), `cashDesc`, `cashAsc`, `ownerNameAsc`, `ownerNameDesc`. Any option besides `none` scans the full selected bucket(s) to guarantee a correct ranking, so it's slower |
| `maxItems` | int | `50` | Hard cap on emitted records (1–5000); with `sortBy: "none"` the scan stops early once reached, otherwise it's the number of top-ranked records kept |

#### Example: search for a common surname

```json
{
  "mode": "search",
  "ownerName": "Smith",
  "valueRange": "500plus",
  "maxItems": 50
}
````

#### Example: find everything a specific company owes

```json
{
  "mode": "browse",
  "holderName": "Bank of America",
  "valueRange": "500plus",
  "maxItems": 100
}
```

#### Example: search by name within a city, high-value only

```json
{
  "mode": "search",
  "ownerName": "Garcia",
  "ownerCity": "Los Angeles",
  "minCashBalance": 1000,
  "valueRange": "500plus",
  "maxItems": 50
}
```

#### Example: browse unclaimed securities

```json
{
  "mode": "browse",
  "propertyTypeContains": "Securities",
  "valueRange": "100to500",
  "maxItems": 200
}
```

#### Example: look up a specific property by ID

```json
{
  "mode": "byId",
  "propertyId": "17285281",
  "valueRange": "500plus"
}
```

#### Example: highest-value accounts, sorted

```json
{
  "mode": "browse",
  "propertyCategory": "AC",
  "sortBy": "cashDesc",
  "valueRange": "500plus",
  "maxItems": 25
}
```

### Use cases

- **Consumer finance apps** — help users check whether the state is holding money owed to them
- **Estate & probate research** — locate unclaimed assets belonging to a deceased relative
- **Skip tracing & asset recovery** — professional locators identifying property to help claim on behalf of owners
- **Business AR recovery** — companies checking whether refunds, uncashed vendor checks, or old payroll ended up with the state
- **Journalism & data research** — analyze unclaimed-property trends by city, business, or property type

### FAQ

**What is the data source?**
The California State Controller's Office (SCO) Unclaimed Property Program, which publishes its complete public database as CSV files, refreshed every Thursday.

**Is this affiliated with the State of California?**
No — this is an independent third-party actor built on the SCO's public data files.

**Why is the database split into value ranges?**
The SCO publishes the ~10+ million property records as four separate files by dollar value to keep individual file sizes manageable. This actor lets you pick which range(s) to search.

**Why does `valueRange: "all"` take longer?**
It scans all four files (several gigabytes of data in total) instead of just one. For most searches, the default `500plus` bucket is both the fastest and the most relevant, since it covers the highest-value properties.

**Does this cover other states?**
No — this actor covers California only, currently the single largest state unclaimed-property program in the US. Most other states run their own separate unclaimed-property programs.

**How do I actually claim property I find?**
Visit the official claim page at claimit.ca.gov and search using the same owner name — the record's `propertyId` helps you identify the exact match.

**How fresh is the data?**
The SCO refreshes its public files weekly (every Thursday). `scrapedAt` on each record reflects when this actor ran, not when the underlying file was last published.

**Why do some records show an out-of-state owner address?**
People move. The state holds property under the last known address reported by the holder business, which is often years old.

# Actor input Schema

## `mode` (type: `string`):

What to do.

## `ownerName` (type: `string`):

Full or partial owner name to search for (case-insensitive substring match against the owner-of-record). Required for mode=search. Example: `Smith`.

## `propertyId` (type: `string`):

Exact SCO property identifier to look up (the `propertyId` field from a previous run's output). Required for mode=byId. If the property isn't found, try `valueRange: "all"` — you may not know which value bucket it lives in.

## `ownerCity` (type: `string`):

Only keep records whose owner city contains this text (case-insensitive).

## `ownerState` (type: `string`):

Only keep records where the owner's on-file state matches exactly. Most owners are in CA, but out-of-state owners are common.

## `ownerZip` (type: `string`):

Only keep records whose owner ZIP code starts with this value. Enter a full 5-digit ZIP (`94105`) or a shorter prefix for a wider area (`941`).

## `ownerCountry` (type: `string`):

Only keep records whose owner country code contains this text (case-insensitive). The SCO stores mostly ISO-3166 alpha-3 codes, e.g. `USA`, `CAN`, `MEX`, `GBR`, `CHN`, `JPN`; a small share of records use 2-letter codes instead, so a short prefix like `US` also works.

## `holderName` (type: `string`):

Only keep records where the company/entity that reported the property (the "holder") contains this text. Useful for finding everything a specific company owes, e.g. `Bank of America`.

## `holderCity` (type: `string`):

Only keep records whose holder (reporting business) city contains this text (case-insensitive).

## `holderState` (type: `string`):

Only keep records where the holder's on-file state matches exactly. Holders are often out-of-state (e.g. insurance/brokerage HQs).

## `propertyTypeContains` (type: `string`):

Only keep records whose NAUPA property-type code/description contains this text, e.g. `Securities`, `Wages`, `Insurance`, `Safe Deposit`, `Utility`.

## `propertyCategory` (type: `string`):

Only keep records in this top-level NAUPA property category (verified against the live database). Records reported under the legacy pre-2-letter numeric codes (~24% of rows, labelled "Non Standard NAUPA Code") aren't classified into these categories and are excluded when a category is chosen — use `propertyTypeContains` to also catch those.

## `cusip` (type: `string`):

Only keep records whose security identifier (CUSIP) matches exactly, e.g. `92343V104`. Only present on securities-type properties.

## `minCashBalance` (type: `integer`):

Drop records with a current cash balance below this amount.

## `maxCashBalance` (type: `integer`):

Drop records with a current cash balance above this amount.

## `valueRange` (type: `string`):

The SCO publishes its database as 4 separate files by dollar value. Smaller buckets download/scan faster. `all` scans every bucket (smallest first) and can take several minutes.

## `maxItems` (type: `integer`):

Hard cap on emitted records. With `sortBy: "none"` the scan stops early once this many matches are found. With any other `sortBy`, this is also the number of top-ranked records kept.

## `sortBy` (type: `string`):

Order emitted records and keep only the top `maxItems`. Any option other than `none` requires scanning the entire selected value-range bucket(s) to guarantee a correct ranking (no early stop), so it's slower — especially with `valueRange: "all"`.

## Actor input object example

```json
{
  "mode": "search",
  "ownerName": "Smith",
  "ownerState": "",
  "holderState": "",
  "propertyCategory": "",
  "valueRange": "500plus",
  "maxItems": 50,
  "sortBy": "none"
}
```

# Actor output Schema

## `unclaimedProperties` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "ownerName": "Smith",
    "ownerState": "",
    "holderState": "",
    "propertyCategory": "",
    "valueRange": "500plus",
    "maxItems": 50,
    "sortBy": "none"
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/ca-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "ownerName": "Smith",
    "ownerState": "",
    "holderState": "",
    "propertyCategory": "",
    "valueRange": "500plus",
    "maxItems": 50,
    "sortBy": "none",
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/ca-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",
  "ownerName": "Smith",
  "ownerState": "",
  "holderState": "",
  "propertyCategory": "",
  "valueRange": "500plus",
  "maxItems": 50,
  "sortBy": "none"
}' |
apify call crawlerbros/ca-unclaimed-property-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=crawlerbros/ca-unclaimed-property-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "California Unclaimed Property Scraper",
        "description": "Search California's official Unclaimed Property database (State Controller's Office) by owner name, city, or holder business. Browse by value range. Free, no login, sourced from the SCO's public weekly data files.",
        "version": "1.0",
        "x-build-id": "wYwBIgVnatB6l9HV8"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/crawlerbros~ca-unclaimed-property-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-crawlerbros-ca-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~ca-unclaimed-property-scraper/runs": {
            "post": {
                "operationId": "runs-sync-crawlerbros-ca-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~ca-unclaimed-property-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-crawlerbros-ca-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"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "search",
                            "browse",
                            "byId"
                        ],
                        "type": "string",
                        "description": "What to do.",
                        "default": "search"
                    },
                    "ownerName": {
                        "title": "Owner name (mode=search)",
                        "type": "string",
                        "description": "Full or partial owner name to search for (case-insensitive substring match against the owner-of-record). Required for mode=search. Example: `Smith`.",
                        "default": "Smith"
                    },
                    "propertyId": {
                        "title": "Property ID (mode=byId)",
                        "type": "string",
                        "description": "Exact SCO property identifier to look up (the `propertyId` field from a previous run's output). Required for mode=byId. If the property isn't found, try `valueRange: \"all\"` — you may not know which value bucket it lives in."
                    },
                    "ownerCity": {
                        "title": "Owner city contains",
                        "type": "string",
                        "description": "Only keep records whose owner city contains this text (case-insensitive)."
                    },
                    "ownerState": {
                        "title": "Owner state",
                        "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": "Only keep records where the owner's on-file state matches exactly. Most owners are in CA, but out-of-state owners are common.",
                        "default": ""
                    },
                    "ownerZip": {
                        "title": "Owner ZIP starts with",
                        "type": "string",
                        "description": "Only keep records whose owner ZIP code starts with this value. Enter a full 5-digit ZIP (`94105`) or a shorter prefix for a wider area (`941`)."
                    },
                    "ownerCountry": {
                        "title": "Owner country contains",
                        "type": "string",
                        "description": "Only keep records whose owner country code contains this text (case-insensitive). The SCO stores mostly ISO-3166 alpha-3 codes, e.g. `USA`, `CAN`, `MEX`, `GBR`, `CHN`, `JPN`; a small share of records use 2-letter codes instead, so a short prefix like `US` also works."
                    },
                    "holderName": {
                        "title": "Holder business name contains",
                        "type": "string",
                        "description": "Only keep records where the company/entity that reported the property (the \"holder\") contains this text. Useful for finding everything a specific company owes, e.g. `Bank of America`."
                    },
                    "holderCity": {
                        "title": "Holder city contains",
                        "type": "string",
                        "description": "Only keep records whose holder (reporting business) city contains this text (case-insensitive)."
                    },
                    "holderState": {
                        "title": "Holder state",
                        "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": "Only keep records where the holder's on-file state matches exactly. Holders are often out-of-state (e.g. insurance/brokerage HQs).",
                        "default": ""
                    },
                    "propertyTypeContains": {
                        "title": "Property type contains",
                        "type": "string",
                        "description": "Only keep records whose NAUPA property-type code/description contains this text, e.g. `Securities`, `Wages`, `Insurance`, `Safe Deposit`, `Utility`."
                    },
                    "propertyCategory": {
                        "title": "Property category",
                        "enum": [
                            "",
                            "AC",
                            "CK",
                            "SC",
                            "MS",
                            "IN",
                            "TR",
                            "MI",
                            "CT",
                            "IR",
                            "UT",
                            "HS",
                            "SD",
                            "CS",
                            "ED"
                        ],
                        "type": "string",
                        "description": "Only keep records in this top-level NAUPA property category (verified against the live database). Records reported under the legacy pre-2-letter numeric codes (~24% of rows, labelled \"Non Standard NAUPA Code\") aren't classified into these categories and are excluded when a category is chosen — use `propertyTypeContains` to also catch those.",
                        "default": ""
                    },
                    "cusip": {
                        "title": "CUSIP",
                        "type": "string",
                        "description": "Only keep records whose security identifier (CUSIP) matches exactly, e.g. `92343V104`. Only present on securities-type properties."
                    },
                    "minCashBalance": {
                        "title": "Min current cash balance (USD)",
                        "minimum": 0,
                        "maximum": 100000000,
                        "type": "integer",
                        "description": "Drop records with a current cash balance below this amount."
                    },
                    "maxCashBalance": {
                        "title": "Max current cash balance (USD)",
                        "minimum": 0,
                        "maximum": 100000000,
                        "type": "integer",
                        "description": "Drop records with a current cash balance above this amount."
                    },
                    "valueRange": {
                        "title": "Value range bucket to scan",
                        "enum": [
                            "500plus",
                            "100to500",
                            "10to100",
                            "under10",
                            "all"
                        ],
                        "type": "string",
                        "description": "The SCO publishes its database as 4 separate files by dollar value. Smaller buckets download/scan faster. `all` scans every bucket (smallest first) and can take several minutes.",
                        "default": "500plus"
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Hard cap on emitted records. With `sortBy: \"none\"` the scan stops early once this many matches are found. With any other `sortBy`, this is also the number of top-ranked records kept.",
                        "default": 50
                    },
                    "sortBy": {
                        "title": "Sort by",
                        "enum": [
                            "none",
                            "cashDesc",
                            "cashAsc",
                            "ownerNameAsc",
                            "ownerNameDesc"
                        ],
                        "type": "string",
                        "description": "Order emitted records and keep only the top `maxItems`. Any option other than `none` requires scanning the entire selected value-range bucket(s) to guarantee a correct ranking (no early stop), so it's slower — especially with `valueRange: \"all\"`.",
                        "default": "none"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
