# Skip Trace | $7/1K | People Search, Address & Phone (`apivault_labs/skip-trace-people-finder`) Actor Skip tracing & people search across the US. Look up anyone by name, address or phone and get current + past addresses, phone numbers, relatives, aliases, emails and a profile link. Real-time public records, no subscription or API key. Basic $7/1K or Premium $15/1K deep profiles. Lawful B2B use only. - **URL**: https://apify.com/apivault\_labs/skip-trace-people-finder.md - **Developed by:** [Apivault Labs](https://apify.com/apivault_labs) (community) - **Categories:** Lead generation, Real estate, Business - **Stats:** 21 total users, 14 monthly users, 99.2% runs succeeded, NaN bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $7.00 / 1,000 result (basic)s This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## ๐Ÿ”Ž Skip Trace | Name, Address & Phone People Lookup **Locate hard-to-find people across the United States.** Search by **name**, **address**, or **phone number** and get a clean, merged contact record โ€” full name, age, current and previous addresses, phone numbers, emails, relatives, aliases, and a public profile link. Bulk input, no API key. > Built for **skip tracers, real-estate wholesalers, process servers, > debt recovery, B2B lead enrichment, and corporate due diligence.** > _Also known as: people search, people finder, person lookup, reverse phone > lookup, address lookup, contact finder, background lookup._ โš–๏ธ **Lawful business use only. This tool is _not_ a consumer reporting agency and must _not_ be used for FCRA-regulated decisions.** See [Legal & Acceptable Use](#๏ธ-legal--acceptable-use) before running. --- ### โญ Why this Skip Trace - **Rated 5.0โ˜…** by users โ€” accuracy people actually trust. - **Real-time public-records lookup** โ€” fresh data on every run, not a stale cached dump. - **Per-person accuracy** โ€” relatives, aliases and address history belong to the *right* individual, never copied page-wide. - **Pay only for hits** โ€” empty lookups are never charged. No subscription, no API key, no per-seat fees. - **3 search modes in one run** โ€” by name, by address, or reverse phone, with bulk arrays. --- ### โšก Quick start ```json { "name": ["James E Whitsitt"], "tier": "basic", "max_results": 3 } ```` Run it, and each matched person comes back as one dataset record. *** ### ๐ŸŽš๏ธ Two tiers โ€” pick what you need | Field | **Basic** ยท $7 / 1K | **Premium** ยท $15 / 1K | |---|:---:|:---:| | Full name + age | โœ… | โœ… | | Current address | โœ… | โœ… | | Phone numbers | โœ… | โœ… | | Public profile link | โœ… | โœ… | | Phone **line types** (Wireless / Landline) | โ€” | โœ… | | Full **address history** | โ€” | โœ… | | **Emails** | โ€” | โœ… | | **Relatives** | โ€” | โœ… | | **Aliases / name variants** | โ€” | โœ… | | **Work & education** hints | โ€” | โœ… | | **Net-worth estimate** (from public real-estate data) | โ€” | โœ… | | **Last-updated date** of the record | โ€” | โœ… | | Date born | โ€” | โœ… | Set `"tier": "basic"` (default) or `"tier": "premium"` in the input. **You only pay for matched records โ€” empty lookups are free.** #### โฌ†๏ธ When to upgrade to Premium ($15/1K) Use **Basic** to *locate* someone fast (name, age, current address, phones). Flip one field โ€” `"tier": "premium"` โ€” when you need to **verify and act**: - **Confirm the right person** with date of birth + full address history - **Reach them on the right line** โ€” Wireless vs Landline types - **Open new contact paths** โ€” relatives, associates, and aliases - **Qualify the lead** โ€” emails + a net-worth estimate from public real-estate data - **Trust the freshness** โ€” each record's last-updated date One field flip roughly doubles the data depth โ€” ideal for wholesalers, collectors and investigators who act on what they find. *** ### ๐Ÿ” Three search modes You can mix all three in a single run. Each value in each array is one lookup. #### 1. By name ```json { "name": [ "James E Whitsitt", "Amalia Castillo; Dallas, TX 75228" ], "max_results": 3 } ``` Add a location after a semicolon โ€” `Name; City, ST ZIP` โ€” to narrow results. #### 2. By address ```json { "street_citystatezip": [ "2551 Pinebluff Dr; Dallas, TX 75228" ] } ``` Returns the people associated with an address. #### 3. By phone (reverse lookup) ```json { "phone_number": ["(214) 321-5304"] } ``` Returns the likely owner of the number. *** ### ๐Ÿ“ค Output One dataset record per matched person. #### Basic ```json { "success": true, "tier": "basic", "searchOption": "Name Search", "inputGiven": "James E Whitsitt", "name": "James Edwin Whitsitt", "age": "83", "currentAddress": "2551 Pinebluff Dr, Dallas, TX 75228", "phones": ["(214) 321-5304", "(214) 321-9044", "(214) 340-9553"], "profileUrl": "https://...", "source": "public-records" } ``` #### Premium (adds the deep-profile fields) ```json { "success": true, "tier": "premium", "name": "James Edwin Whitsitt", "age": "83", "born": "February 1949", "currentAddress": "2551 Pinebluff Dr, Dallas, TX 75228", "phones": ["(214) 321-5304", "(214) 321-9044"], "phonesDetailed": [ { "number": "(214) 321-5304", "type": "Wireless" }, { "number": "(214) 321-9044", "type": "Landline" } ], "emails": ["example@email.com"], "aliases": ["Jim Whitsitt"], "relatives": ["Janice Whitsitt", "Goldie Whitsitt"], "previousAddresses": [ "928 Meadowcove Cir, Garland, TX 75043", "13510 N Central Expy, Dallas, TX 75243" ], "addressHistory": ["..."], "workHints": ["Engineer"], "educationHints": ["University of Texas"], "netWorthEstimate": "$277,760", "lastUpdated": "March 26, 2025", "profileUrl": "https://...", "source": "public-records" } ``` *** ### โš™๏ธ Input parameters | Field | Type | Default | Description | |---|---|---|---| | `name` | array | โ€” | Full names (optionally `Name; City, ST ZIP`) | | `street_citystatezip` | array | โ€” | Addresses to resolve to people | | `phone_number` | array | โ€” | Phone numbers for reverse lookup | | `tier` | enum | `basic` | `basic` ($7/1K) or `premium` ($15/1K, deep profile) | | `max_results` | int | `5` | Matched people returned per input value (1โ€“20) | | `maxRetries` | int | `3` | Retries on a transient source response | | `timeout` | int | `35` | Seconds per request | At least one of `name`, `street_citystatezip`, or `phone_number` is required. *** ### ๐Ÿ’ฐ Pricing | Tier | Per result | Per 1,000 | |---|---|---| | Basic | $0.007 | **$7** | | Premium | $0.015 | **$15** | - Pay-per-result โ€” **empty lookups are not charged**. - No subscriptions, no API keys, no per-seat fees. *** ### ๐Ÿ’ก Use cases - **Skip tracing** โ€” locate debtors, defendants, beneficiaries, lost contacts - **Real-estate wholesaling** โ€” reach property owners behind an address - **Process serving** โ€” find a current address for lawful service - **Debt recovery & collections** โ€” locate account holders - **B2B data enrichment** โ€” append phones / addresses to a contact list - **Corporate due diligence & fraud investigation** โ€” verify identity & history *** ### โญ Found this useful? If this Actor saved you time, a quick **rating on its Apify page** genuinely helps other skip tracers find it โ€” and helps us keep improving accuracy and coverage. Thank you! ๐Ÿ™ *** ### โš–๏ธ Legal & Acceptable Use **Please read this section carefully. By running this Actor you agree to it.** **1. Public information only.** This Actor returns information that is already **publicly available** through people-search and public-records sources. It performs no hacking, account access, or retrieval of private/protected data. **2. Not a Consumer Reporting Agency.** This Actor and its operator are **not a consumer reporting agency (CRA)** as defined by the U.S. Fair Credit Reporting Act (FCRA), and the data is **not a "consumer report."** You may **NOT** use this Actor or its output, in whole or in part, to make decisions about a person's eligibility for: - credit or loans, - employment, hiring, promotion, or retention, - housing, rental, or tenant screening, - insurance, or - any other purpose regulated by the FCRA. **3. Your compliance obligations.** You are solely responsible for using the data lawfully and for complying with all applicable laws and regulations, including but not limited to the **FCRA**, the **Driver's Privacy Protection Act (DPPA)**, the **Gramm-Leach-Bliley Act (GLBA)**, the **Telephone Consumer Protection Act (TCPA)**, and state privacy laws such as the **CCPA/CPRA** and similar statutes. You must have a **legitimate, lawful purpose** for each lookup and the right to process the data you submit and receive. **4. Prohibited uses.** You may **not** use this Actor to: - stalk, harass, threaten, intimidate, or harm any person, - "dox" or publicly expose an individual, - discriminate against any person on the basis of a protected characteristic, - engage in identity theft, fraud, or any unlawful surveillance, or - violate any person's privacy rights or any platform's terms of service. **5. No affiliation.** This Actor is an **independent tool**. It is **not affiliated with, endorsed by, or sponsored by** any people-search website, data provider, or any company whose name may appear in results. **6. Accuracy / "AS IS".** Public-records data can be incomplete, outdated, or inaccurate, and records may belong to a different person with a similar name. Results are provided **"AS IS," without warranties of any kind**, express or implied, including accuracy, completeness, or fitness for a particular purpose. **Always independently verify** before relying on any result. **7. Data-subject requests.** Individuals who wish to remove their information should contact the **original source website** that publishes it; the operator of this Actor does not own, host, or control those records. **8. Limitation of liability & indemnification.** To the maximum extent permitted by law, the operator is not liable for any damages arising from your use of this Actor, and **you agree to indemnify and hold the operator harmless** from any claims, losses, or liabilities resulting from your use or misuse of the Actor or its output. > If you are unsure whether your intended use is permitted, consult your own > legal counsel before running this Actor. *** ### ๐Ÿ“ Notes - **US coverage.** Results depend on what the public sources expose. - A **US proxy** is used (datacenter by default โ€” free and reliable for this source; switch to residential only if you hit blocks on heavy volume). - Phone and address modes return whatever the source associates with the input value. - Records with no match are returned with `"success": false` and are not charged. - Every run starts with a `recordType: "notice"` record and every result carries a `complianceNotice` field restating the acceptable-use terms. # Actor input Schema ## `name` (type: `array`): Full names to look up. Optionally add a location after a semicolon to narrow results, e.g. "Amalia Castillo; Dallas, TX 75228". ## `street_citystatezip` (type: `array`): Street addresses with city, state, ZIP. Example: "2551 Pinebluff Dr; Dallas, TX 75228". Finds people associated with the address. ## `phone_number` (type: `array`): US phone numbers for reverse lookup. Example: "(214) 321-5304". ## `max_results` (type: `integer`): How many matched people to return per input value. Each source page holds ~15 people; values above 15 fetch additional pages. Default 10. ## `tier` (type: `string`): basic = fast lookup (name, age, current address, phones, profile link) at $7/1K. premium = opens each person's full profile and adds phone line types, full address history, emails, relatives, aliases, work/education hints, net-worth estimate, and the record's last-updated date at $15/1K. ## `maxRetries` (type: `integer`): Retry attempts when the source returns a transient anti-bot response. ## `timeout` (type: `integer`): Max wait per page fetch. ## `useResidential` (type: `boolean`): On by default. Tries fast free datacenter IPs first, then automatically falls back to residential IPs when the source blocks the datacenter (which it usually does). The search response is small, so the residential cost is only a fraction of a cent per run. Turn this off only if you want datacenter-only (free, but most lookups will be blocked). ## `maxConcurrency` (type: `integer`): How many lookups (and profile pages) to fetch in parallel. Higher is faster but hits the source harder; 4 is a good balance. ## Actor input object example ```json { "name": [ "James E Whitsitt" ], "max_results": 10, "tier": "basic", "maxRetries": 2, "timeout": 25, "useResidential": true, "maxConcurrency": 4 } ``` # 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 = { "name": [ "James E Whitsitt" ] }; // Run the Actor and wait for it to finish const run = await client.actor("apivault_labs/skip-trace-people-finder").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 = { "name": ["James E Whitsitt"] } # Run the Actor and wait for it to finish run = client.actor("apivault_labs/skip-trace-people-finder").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 '{ "name": [ "James E Whitsitt" ] }' | apify call apivault_labs/skip-trace-people-finder --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=apivault_labs/skip-trace-people-finder", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Skip Trace | $7/1K | People Search, Address & Phone", "description": "Skip tracing & people search across the US. Look up anyone by name, address or phone and get current + past addresses, phone numbers, relatives, aliases, emails and a profile link. Real-time public records, no subscription or API key. Basic $7/1K or Premium $15/1K deep profiles. Lawful B2B use only.", "version": "0.3", "x-build-id": "OpmW4K7q0pLf43n5M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apivault_labs~skip-trace-people-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apivault_labs-skip-trace-people-finder", "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/apivault_labs~skip-trace-people-finder/runs": { "post": { "operationId": "runs-sync-apivault_labs-skip-trace-people-finder", "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/apivault_labs~skip-trace-people-finder/run-sync": { "post": { "operationId": "run-sync-apivault_labs-skip-trace-people-finder", "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": { "name": { "title": "Names", "type": "array", "description": "Full names to look up. Optionally add a location after a semicolon to narrow results, e.g. \"Amalia Castillo; Dallas, TX 75228\".", "items": { "type": "string" } }, "street_citystatezip": { "title": "Addresses", "type": "array", "description": "Street addresses with city, state, ZIP. Example: \"2551 Pinebluff Dr; Dallas, TX 75228\". Finds people associated with the address.", "items": { "type": "string" } }, "phone_number": { "title": "Phone numbers", "type": "array", "description": "US phone numbers for reverse lookup. Example: \"(214) 321-5304\".", "items": { "type": "string" } }, "max_results": { "title": "Max results per query", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many matched people to return per input value. Each source page holds ~15 people; values above 15 fetch additional pages. Default 10.", "default": 10 }, "tier": { "title": "Tier (basic / premium)", "enum": [ "basic", "premium" ], "type": "string", "description": "basic = fast lookup (name, age, current address, phones, profile link) at $7/1K. premium = opens each person's full profile and adds phone line types, full address history, emails, relatives, aliases, work/education hints, net-worth estimate, and the record's last-updated date at $15/1K.", "default": "basic" }, "maxRetries": { "title": "Retries on transient failure", "minimum": 0, "maximum": 3, "type": "integer", "description": "Retry attempts when the source returns a transient anti-bot response.", "default": 2 }, "timeout": { "title": "Timeout per request (seconds)", "minimum": 10, "maximum": 45, "type": "integer", "description": "Max wait per page fetch.", "default": 25 }, "useResidential": { "title": "Use residential proxy fallback (recommended)", "type": "boolean", "description": "On by default. Tries fast free datacenter IPs first, then automatically falls back to residential IPs when the source blocks the datacenter (which it usually does). The search response is small, so the residential cost is only a fraction of a cent per run. Turn this off only if you want datacenter-only (free, but most lookups will be blocked).", "default": true }, "maxConcurrency": { "title": "Max parallel lookups", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many lookups (and profile pages) to fetch in parallel. Higher is faster but hits the source harder; 4 is a good balance.", "default": 4 } } }, "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 } } } } } } } } } } ```