# Skip Trace People Search (`parseforge/skip-trace-scraper`) Actor

Find people across the United States by name and state. Pull full names, all known addresses with street, city, state, ZIP, plus profile URLs and name variants. City-level pagination across the top 10 cities per state. Export to JSON, CSV, or Excel for due diligence and skip tracing.

- **URL**: https://apify.com/parseforge/skip-trace-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Lead generation, Business, Other
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $13.50 / 1,000 items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🔍 Skip Trace People Search

> 🚀 **Find people across the United States by name and state.** Pull full names, all known historical addresses with city, state, and ZIP, plus profile URLs. No login, no API key.

> 🕒 **Last updated:** 2026-05-01 · **📊 9 fields** per record · **🇺🇸 50 US states** · **🏙️ top 10 cities per state** · **🆓 public address record**

The **Skip Trace People Search Scraper** queries the public Spokeo state directory for any first name, last name, and state combination. Each record includes the full name, name variants from the public record, every known historical address with street, city, state, and ZIP, and the canonical profile URL.

City-level pagination across the top ten cities per state lifts the per-query cap from roughly 30 to 100+ unique people. Skip tracing has long been a manual research task for legal teams, real estate investors, debt collectors, and journalists. This Actor turns the public address record into structured data without manual lookups.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| Real estate investors, legal teams, debt recovery, journalists, OSINT researchers | Address verification, asset tracing, contact research, due diligence |

---

### 📋 What the Skip Trace People Search Scraper does

Four filtering workflows in a single run:

- 👤 **Name + state lookup.** Submit a first name, last name, and US state.
- 🏙️ **City pagination.** When the state-level page caps out, the Actor walks the top 10 cities for that state.
- 🔗 **Profile URLs.** Each record carries a canonical Spokeo profile URL for follow-up research.
- 🏷️ **Name variants.** The public record often lists middle initials and historical surnames as alias entries.

Each row reports the full name, an array of name variants, an array of historical addresses (each with street, city, state, ZIP, and a combined fullAddress), the profile URL, the original search inputs (first name, last name, state), the source (`spokeo`), and a scrape timestamp.

> 💡 **Why it matters:** the public address record is the foundation of US skip tracing. Real estate investors use it to find off-market property owners. Legal teams use it for service of process. Debt recovery uses it to locate debtors. The state pages on Spokeo are the highest-quality public surface for this data, and city-level pagination is the practical way to break past per-query caps.

---

### 🎬 Full Demo

_🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset._

---

### ⚙️ Input

<table>
<thead>
<tr><th>Input</th><th>Type</th><th>Default</th><th>Behavior</th></tr>
</thead>
<tbody>
<tr><td><code>maxItems</code></td><td>integer</td><td><code>10</code></td><td>People to return. Free plan caps at 10, paid plan at 1,000,000.</td></tr>
<tr><td><code>firstName</code></td><td>string</td><td><code>"John"</code></td><td>First name to search for.</td></tr>
<tr><td><code>lastName</code></td><td>string</td><td><code>"Smith"</code></td><td>Last name to search for.</td></tr>
<tr><td><code>state</code></td><td>string</td><td><code>"California"</code></td><td>Full US state name from a 50-state enum.</td></tr>
</tbody>
</table>

**Example: 100 people named John Smith in California.**

```json
{
    "maxItems": 100,
    "firstName": "John",
    "lastName": "Smith",
    "state": "California"
}
````

**Example: a less common name in Texas.**

```json
{
    "maxItems": 50,
    "firstName": "Aurelia",
    "lastName": "Vasquez",
    "state": "Texas"
}
```

> ⚠️ **Good to Know:** state names use hyphens (`New-York`, `North-Carolina`). The state-page is the primary surface; city-level pagination only triggers when the state page returns fewer than `maxItems` records. Phone numbers and emails are paywalled on Spokeo and are not exposed by this Actor.

***

### 📊 Output

Each person record contains **9 fields**. Download as CSV, Excel, JSON, or XML.

#### 🧾 Schema

| Field | Type | Example |
|---|---|---|
| 👤 `fullName` | string | `"John N Smith"` |
| 🏷️ `additionalNames` | array | `["John N Smith"]` |
| 🏠 `addresses` | array of objects | see below |
| 🔗 `profileUrl` | string | `"https://www.spokeo.com/John-N-Smith/..."` |
| 🔍 `searchedFirstName` | string | `"John"` |
| 🔍 `searchedLastName` | string | `"Smith"` |
| 🔍 `searchedState` | string | `"California"` |
| 📡 `source` | string | `"spokeo"` |
| 🕒 `scrapedAt` | ISO 8601 | `"2026-05-01T01:14:33.402Z"` |

Each address inside `addresses` has:

| Field | Type | Example |
|---|---|---|
| 🏠 `streetAddress` | string | null | `"11136 Provencal Pl"` |
| 🏙️ `city` | string | null | `"San Diego"` |
| 🗺️ `state` | string | null | `"CA"` |
| 📮 `postalCode` | string | null | `"92128"` |
| 📍 `fullAddress` | string | `"11136 Provencal Pl, San Diego, CA, 92128"` |

#### 📦 Sample records

<details>
<summary><strong>👤 Person with multiple historical addresses across states</strong></summary>

```json
{
    "fullName": "John N Smith",
    "additionalNames": ["John N Smith"],
    "addresses": [
        {"streetAddress": "11136 Provencal Pl", "city": "San Diego", "state": "CA", "postalCode": "92128", "fullAddress": "11136 Provencal Pl, San Diego, CA, 92128"},
        {"streetAddress": "715 Ne Redbud Ln", "city": "Bremerton", "state": "WA", "postalCode": "98311", "fullAddress": "715 Ne Redbud Ln, Bremerton, WA, 98311"},
        {"streetAddress": "7765 Saranac Pl, Unit 36", "city": "La Mesa", "state": "CA", "postalCode": "91942", "fullAddress": "7765 Saranac Pl, Unit 36, La Mesa, CA, 91942"}
    ],
    "profileUrl": "https://www.spokeo.com/John-Smith/California/San-Diego/p2017030807173912183292855",
    "searchedFirstName": "John",
    "searchedLastName": "Smith",
    "searchedState": "California",
    "source": "spokeo"
}
```

</details>

<details>
<summary><strong>👥 Person with a name variant in the public record</strong></summary>

```json
{
    "fullName": "Mary E Johnson",
    "additionalNames": ["Mary E Johnson", "Mary Elizabeth Smith"],
    "addresses": [
        {"streetAddress": "421 Oak Ridge Dr", "city": "Houston", "state": "TX", "postalCode": "77024", "fullAddress": "421 Oak Ridge Dr, Houston, TX, 77024"}
    ],
    "profileUrl": "https://www.spokeo.com/Mary-E-Johnson/Texas/Houston/...",
    "source": "spokeo"
}
```

</details>

<details>
<summary><strong>🏙️ City-page result reached via pagination</strong></summary>

```json
{
    "fullName": "Aurelia M Vasquez",
    "additionalNames": ["Aurelia M Vasquez"],
    "addresses": [
        {"streetAddress": "230 Maple St", "city": "Dallas", "state": "TX", "postalCode": "75204", "fullAddress": "230 Maple St, Dallas, TX, 75204"}
    ],
    "profileUrl": "https://www.spokeo.com/Aurelia-Vasquez/Texas/Dallas/...",
    "source": "spokeo"
}
```

</details>

***

### ✨ Why choose this Actor

| | Capability |
|---|---|
| 🆓 | **No login.** Reads the public Spokeo state directory. |
| 🇺🇸 | **All 50 states.** Full US coverage via state-name enum. |
| 🏙️ | **City pagination.** Top 10 cities per state to reach 100+ records. |
| 🏷️ | **Name variants.** Captures middle initials and historical surnames. |
| 🏠 | **Multiple addresses.** Full address history per person. |
| 🔗 | **Profile URLs.** Stable canonical links for follow-up research. |
| 🚀 | **Sub-30-second runs.** Typical 100-person pulls finish quickly. |

> 📊 In a single 18-second run the Actor returned 100 unique people named John Smith across California cities.

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Filters | Setup |
|---|---|---|---|---|---|
| Manual public-record search | Free | One-shot per query | Live | Manual | Hours per state |
| Paid people-search subscriptions | $$$ subscription | Full | Daily | Built-in | Account setup |
| Generic web scrapers | $$ subscription | Brittle CSS | Daily | None | Engineer hours |
| **⭐ Skip Trace People Search** *(this Actor)* | Pay-per-event | 100+ per state | Live | Name, state, city pagination | None |

Same Spokeo state directory open to any browser, exposed as structured records.

***

### 🚀 How to use

1. 🆓 **Create a free Apify account.** [Sign up here](https://console.apify.com/sign-up?fpr=vmoqkp) and get $5 in free credit.
2. 🔍 **Open the Actor.** Search for "Skip Trace" in the Apify Store.
3. ⚙️ **Enter inputs.** First name, last name, US state.
4. ▶️ **Click Start.** A 100-person run typically completes in 15 to 30 seconds.
5. 📥 **Download.** Export as CSV, Excel, JSON, or XML.

> ⏱️ Total time from sign-up to first dataset: under five minutes.

***

### 💼 Business use cases

<table>
<tr>
<td width="50%">

#### 🏠 Real estate

- Find off-market property owners
- Verify owner addresses for direct mail
- Identify absentee owners across states
- Reach inheritance-stage owners early

</td>
<td width="50%">

#### ⚖️ Legal & process

- Locate parties for service of process
- Verify residency for jurisdictional filings
- Trace witnesses and former employees
- Build location histories for case research

</td>
</tr>
<tr>
<td width="50%">

#### 💰 Debt & collections

- Locate debtors who have moved
- Identify last-known address bundles
- Cross-reference multiple state records
- Surface name variants for fuzzy matching

</td>
<td width="50%">

#### 📰 Journalism & OSINT

- Trace public figures' historical addresses
- Verify leaked-document metadata
- Find related parties via shared addresses
- Build narrative timelines anchored on residence

</td>
</tr>
</table>

***

### 🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

<table>
<tr>
<td width="50%">

#### 🎓 Research and academia

- Empirical datasets for papers, thesis work, and coursework
- Longitudinal studies tracking changes across snapshots
- Reproducible research with cited, versioned data pulls
- Classroom exercises on data analysis and ethical scraping

</td>
<td width="50%">

#### 🎨 Personal and creative

- Side projects, portfolio demos, and indie app launches
- Data visualizations, dashboards, and infographics
- Content research for bloggers, YouTubers, and podcasters
- Hobbyist collections and personal trackers

</td>
</tr>
<tr>
<td width="50%">

#### 🤝 Non-profit and civic

- Transparency reporting and accountability projects
- Advocacy campaigns backed by public-interest data
- Community-run databases for local issues
- Investigative journalism on public records

</td>
<td width="50%">

#### 🧪 Experimentation

- Prototype AI and machine-learning pipelines with real data
- Validate product-market hypotheses before engineering spend
- Train small domain-specific models on niche corpora
- Test dashboard concepts with live input

</td>
</tr>
</table>

***

### 🔌 Automating Skip Trace People Search

Run this Actor on a schedule, from your codebase, or inside another tool:

- **Node.js** SDK: see [Apify JavaScript client](https://docs.apify.com/api/client/js/) for programmatic runs.
- **Python** SDK: see [Apify Python client](https://docs.apify.com/api/client/python/) for the same flow in Python.
- **HTTP API**: see [Apify API docs](https://docs.apify.com/api/v2) for raw REST integration.

Schedule recurring runs on a list of names from the Apify Console. Pipe results into Google Sheets, S3, BigQuery, or your own webhook with the built-in [integrations](https://docs.apify.com/platform/integrations).

***

### ❓ Frequently Asked Questions

<details>
<summary><strong>📞 Does it return phone numbers and emails?</strong></summary>

No. Phone and email contact details are paywalled on Spokeo and are not exposed by this Actor. The output covers names, address history, and the canonical profile URL only.

</details>

<details>
<summary><strong>🏙️ How does city pagination work?</strong></summary>

If the state page returns fewer than `maxItems`, the Actor walks the top 10 cities for that state appending `/{City}` to the URL. Spokeo serves a separate set of records per city.

</details>

<details>
<summary><strong>👤 What are additionalNames?</strong></summary>

Spokeo's public record sometimes lists middle initials, married names, and historical aliases attached to the same person. They appear in the `additionalNames` array.

</details>

<details>
<summary><strong>🏠 How accurate is the address history?</strong></summary>

The address record reflects what Spokeo has aggregated from public records. Older addresses are typically accurate; very recent moves may not be reflected immediately.

</details>

<details>
<summary><strong>🇺🇸 Are non-US people supported?</strong></summary>

No. Spokeo focuses on the US public record. Other countries are not covered.

</details>

<details>
<summary><strong>📦 How many people can I pull at once?</strong></summary>

Free plan caps at 10. Paid plans go up to 1,000,000. Per-query the Actor reaches 100+ via city pagination.

</details>

<details>
<summary><strong>🔠 Why are state names hyphenated?</strong></summary>

Spokeo URL-encodes state names with hyphens for two-word states like `New-York` and `North-Carolina`. Match the enum values exactly.

</details>

<details>
<summary><strong>💼 Can I use this for commercial work?</strong></summary>

Yes for permissible purposes. Always confirm your jurisdiction's rules around skip tracing and data use. The Actor reads only what Spokeo publicly serves to any browser.

</details>

<details>
<summary><strong>💳 Do I need a paid Apify plan?</strong></summary>

The free plan returns up to 10 records per run. Paid plans return up to 1,000,000.

</details>

<details>
<summary><strong>⚠️ What if a run returns no records?</strong></summary>

Try a more common name or a more populous state. If a real lookup returns nothing, [open a contact form](https://tally.so/r/BzdKgA) and include the run URL.

</details>

<details>
<summary><strong>🔁 How fresh is the data?</strong></summary>

Live. Each run hits Spokeo at run time.

</details>

<details>
<summary><strong>⚖️ Is this legal?</strong></summary>

The Actor reads only data Spokeo publishes openly to every browser visitor. Skip tracing for permitted purposes (collections, fraud investigation, legal process) is allowed in the US under the Fair Credit Reporting Act and state-level rules. Always verify your specific use case complies with local law.

</details>

***

### 🔌 Integrate with any app

- [**Make**](https://apify.com/integrations/make) - drop run results into 1,800+ apps.
- [**Zapier**](https://apify.com/integrations/zapier) - trigger automations off completed runs.
- [**Slack**](https://apify.com/integrations/slack) - post run summaries to a channel.
- [**Google Sheets**](https://apify.com/integrations/google-sheets) - sync each run into a spreadsheet.
- [**Webhooks**](https://docs.apify.com/platform/integrations/webhooks) - notify your own services on run finish.
- [**Airbyte**](https://apify.com/integrations/airbyte) - load runs into Snowflake, BigQuery, or Postgres.

***

### 🔗 Recommended Actors

- [**⚖️ California State Bar Scraper**](https://apify.com/parseforge/california-state-bar-scraper) - look up California attorneys by name or bar number.
- [**🏛️ Federal Court Locator Scraper**](https://apify.com/parseforge/pacer-court-locator-scraper) - find the right federal court for filings.
- [**🅱️ Bing Search Scraper**](https://apify.com/parseforge/bing-search-scraper) - run open-web searches on the people you find.
- [**🦆 DuckDuckGo Search Scraper**](https://apify.com/parseforge/duckduckgo-search-scraper) - alternative SERP signal for the same lookup.
- [**🕰️ Wayback Machine CDX Scraper**](https://apify.com/parseforge/wayback-cdx-scraper) - audit historical web mentions of a person.

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more pre-built scrapers and data tools.

***

**🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) and we'll route the question to the right person.

***

> Spokeo is a registered trademark of Spokeo, Inc. This Actor is not affiliated with or endorsed by Spokeo. It reads only the publicly-visible state directory pages every browser can access. Use of skip-trace data is governed by US Fair Credit Reporting Act and state-level rules; verify your use case with counsel.

# Actor input Schema

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

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000.

## `firstName` (type: `string`):

First name to search for.

## `lastName` (type: `string`):

Last name to search for.

## `state` (type: `string`):

Full US state name.

## Actor input object example

```json
{
  "maxItems": 10,
  "firstName": "John",
  "lastName": "Smith",
  "state": "California"
}
```

# 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 = {
    "maxItems": 10,
    "firstName": "John",
    "lastName": "Smith",
    "state": "California"
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/skip-trace-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 = {
    "maxItems": 10,
    "firstName": "John",
    "lastName": "Smith",
    "state": "California",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/skip-trace-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 '{
  "maxItems": 10,
  "firstName": "John",
  "lastName": "Smith",
  "state": "California"
}' |
apify call parseforge/skip-trace-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Skip Trace People Search",
        "description": "Find people across the United States by name and state. Pull full names, all known addresses with street, city, state, ZIP, plus profile URLs and name variants. City-level pagination across the top 10 cities per state. Export to JSON, CSV, or Excel for due diligence and skip tracing.",
        "version": "1.0",
        "x-build-id": "CsREUhnSuB7v4Ury4"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~skip-trace-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-skip-trace-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/parseforge~skip-trace-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-skip-trace-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/parseforge~skip-trace-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-skip-trace-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",
                "properties": {
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000."
                    },
                    "firstName": {
                        "title": "First name",
                        "type": "string",
                        "description": "First name to search for."
                    },
                    "lastName": {
                        "title": "Last name",
                        "type": "string",
                        "description": "Last name to search for."
                    },
                    "state": {
                        "title": "US state",
                        "enum": [
                            "Alabama",
                            "Alaska",
                            "Arizona",
                            "Arkansas",
                            "California",
                            "Colorado",
                            "Connecticut",
                            "Delaware",
                            "Florida",
                            "Georgia",
                            "Hawaii",
                            "Idaho",
                            "Illinois",
                            "Indiana",
                            "Iowa",
                            "Kansas",
                            "Kentucky",
                            "Louisiana",
                            "Maine",
                            "Maryland",
                            "Massachusetts",
                            "Michigan",
                            "Minnesota",
                            "Mississippi",
                            "Missouri",
                            "Montana",
                            "Nebraska",
                            "Nevada",
                            "New-Hampshire",
                            "New-Jersey",
                            "New-Mexico",
                            "New-York",
                            "North-Carolina",
                            "North-Dakota",
                            "Ohio",
                            "Oklahoma",
                            "Oregon",
                            "Pennsylvania",
                            "Rhode-Island",
                            "South-Carolina",
                            "South-Dakota",
                            "Tennessee",
                            "Texas",
                            "Utah",
                            "Vermont",
                            "Virginia",
                            "Washington",
                            "West-Virginia",
                            "Wisconsin",
                            "Wyoming"
                        ],
                        "type": "string",
                        "description": "Full US state name.",
                        "default": "California"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
