# People Search Scraper: FastPeopleSearch & TruePeopleSearch (`getascraper/people-search-lookup-scraper`) Actor

Search FastPeopleSearch and TruePeopleSearch by name for skip tracing or lead generation. Get age, addresses, phone numbers, and relatives as structured JSON, with monitor mode for tracking changes. No third-party API key needed. Not for FCRA-regulated screening use.

- **URL**: https://apify.com/getascraper/people-search-lookup-scraper.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.90 / 1,000 person records

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## 🔍 People Search Lookup Scraper: FastPeopleSearch & TruePeopleSearch

<table width="100%"><tr><td style="padding:24px 28px;background:#EEF0F6;border:1px solid #C7CCDA;border-top:4px solid #2D3A5C;border-radius:12px"><span style="font-size:23px;font-weight:800;color:#1C1917;line-height:1.3">Search two public-records sites in one run, and get alerted when a contact changes.</span><br><span style="font-size:15px;color:#57534E;line-height:1.6">Look up a name across FastPeopleSearch and TruePeopleSearch and get age, addresses, phone numbers, and relatives as structured data, with a monitor mode that flags what's changed since your last check.</span></td></tr></table>

<table width="100%"><tr><td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C7CCDA;border-radius:10px 0 0 10px;vertical-align:top"><span style="font-size:15px;font-weight:800;color:#2D3A5C">🔍 Two sites, one run</span><br><span style="font-size:12px;color:#57534E">FastPeopleSearch and TruePeopleSearch searched together, not as separate tools.</span></td><td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C7CCDA;border-left:none;vertical-align:top"><span style="font-size:15px;font-weight:800;color:#2D3A5C">📞 Phone lookup</span><br><span style="font-size:12px;color:#57534E">Optional phone number detail with type and carrier.</span></td><td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C7CCDA;border-left:none;vertical-align:top"><span style="font-size:15px;font-weight:800;color:#2D3A5C">💳 No extra API key</span><br><span style="font-size:12px;color:#57534E">Works on its own. No third-party unlocker account to sign up for.</span></td><td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C7CCDA;border-left:none;border-radius:0 10px 10px 0;vertical-align:top"><span style="font-size:15px;font-weight:800;color:#2D3A5C">🔁 Change monitor</span><br><span style="font-size:12px;color:#57534E">Schedule it and only get results when something's changed.</span></td></tr></table>

People Search Lookup Scraper searches [FastPeopleSearch](https://www.fastpeoplesearch.com) and [TruePeopleSearch](https://www.truepeoplesearch.com) by name and returns each match as a clean, structured record. Run it on demand or on an Apify schedule to track down a hard-to-reach contact, build a prospect list, or check whether someone's known address or phone has changed since you last looked.

### 🎯 What this Actor does

Skip tracers and process servers use it to locate current contact details for debt collection and legal service without opening two separate sites by hand. Real estate wholesalers use it to find property owner contact information for outreach. Corporate investigators and background researchers use it to cross-reference a name across two independent public-records sources in one pass. Every field is genuine: if a site doesn't publish a value, it's left out rather than filled with a placeholder.

**This Actor is not built or intended for FCRA-regulated screening.** Don't use it for employment decisions, credit decisions, tenant screening, or insurance underwriting. It returns only what FastPeopleSearch and TruePeopleSearch publish as public records, one source at a time, never merged into a "verified" identity claim.

### 🚀 How to use it

<table width="100%"><tr><td style="padding:16px 14px;width:33%;background:#EEF0F6;border:1px solid #C7CCDA;border-radius:10px 0 0 10px;vertical-align:top"><span style="font-size:12px;font-weight:800;color:#2D3A5C;letter-spacing:1px">STEP 1</span><br><span style="font-size:14px;font-weight:700;color:#1C1917">Enter a name</span><br><span style="font-size:12px;color:#57534E">Add a city and state to narrow the search to a specific person.</span></td><td style="padding:16px 14px;width:33%;background:#EEF0F6;border:1px solid #C7CCDA;border-left:none;vertical-align:top"><span style="font-size:12px;font-weight:800;color:#2D3A5C;letter-spacing:1px">STEP 2</span><br><span style="font-size:14px;font-weight:700;color:#1C1917">Run it</span><br><span style="font-size:12px;color:#57534E">Start the Actor directly or trigger it from an Apify schedule for recurring checks.</span></td><td style="padding:16px 14px;width:33%;background:#EEF0F6;border:1px solid #C7CCDA;border-left:none;border-radius:0 10px 10px 0;vertical-align:top"><span style="font-size:12px;font-weight:800;color:#2D3A5C;letter-spacing:1px">STEP 3</span><br><span style="font-size:14px;font-weight:700;color:#1C1917">Export or connect</span><br><span style="font-size:12px;color:#57534E">Download the dataset or send it straight to a downstream integration.</span></td></tr></table>

### 🧩 Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| Full name | string | Yes | The person's full name to search for. |
| City | string | No | Optional city to narrow the search. |
| State | string | No | Optional two-letter state code to narrow the search. |
| Sources | array of enums | No | Which sites to search. Leave empty to search both. |
| Include phone numbers | boolean | No | Fetch each result's detail page for phone numbers. Slower, and TruePeopleSearch detail pages are best-effort due to that site's own CAPTCHA gate. |
| Max items | integer | No | Maximum number of person records to return. |
| Incremental monitor mode | boolean | No | Only return records that are new or changed since your last run with the same monitor state name. |
| Monitor state name | string | No | Name for this run's incremental state. Use different names to track separate lookups independently. |

### 📊 Data table

| Field | Type | Description |
| --- | --- | --- |
| `fullName` | string | Name as listed on the source site. |
| `age` | string | Age, when published. |
| `location` | string | Current city and state. |
| `pastAddresses` | array | Previously listed addresses. |
| `relatives` | array | Possible relatives listed on the source. |
| `aliases` | array | Also-known-as names, when published. |
| `phoneNumbers` | array | Phone numbers with type and carrier. Present with phone lookup on. |
| `sourceSite` | string | `fastpeoplesearch` or `truepeoplesearch`. |
| `sourceUrl` | string | Link to the original public record. |
| `changeType` | string | `NEW`, `UPDATED`, or `CURRENT`, present only in incremental monitor mode. |
| `scrapedAt` | string | Time the Actor collected the record. |

### 💰 Pricing

This Actor uses pay per event pricing. Empty runs cost nothing, and there are no subscriptions.

### ⭐ Enjoying People Search Lookup Scraper?

<table width="100%" style="display:table;width:100%"><tr><td style="padding:20px 24px 14px;background:#EEF0F6;border:1px solid #C7CCDA;border-left:5px solid #2D3A5C;border-radius:10px 10px 0 0"><span style="font-size:20px;letter-spacing:4px">⭐ ⭐ ⭐ ⭐ ⭐</span><br><span style="font-size:17px;font-weight:800;color:#1C1917">If this saves you from checking two sites by hand, a rating helps more skip tracers and researchers find it.</span><br><span style="font-size:14px;color:#57534E">Your feedback tells us which fields and sources to add next.</span></td></tr><tr><td style="padding:0;background:#2D3A5C;border:1px solid #C7CCDA;border-top:none;border-radius:0 0 10px 10px;text-align:center"><a href="https://apify.com/getascraper/people-search-lookup-scraper/reviews" style="display:block;padding:13px 16px;color:#FFFFFF;text-decoration:none;font-weight:800;font-size:15px;letter-spacing:0.3px">★&nbsp;&nbsp;Rate this Actor on Apify</a></td></tr></table>

### ❓ FAQ

#### Can I use this for background checks or tenant screening?

No. This Actor is not built for FCRA-regulated use such as employment, credit, tenant, or insurance decisions. It returns only public records published by FastPeopleSearch and TruePeopleSearch.

#### Does it search both sites in one run?

Yes. Leave the sources field empty and it searches both. You can also select just one site if you only need one source.

#### Can I get phone numbers?

Yes, turn on the phone number option. FastPeopleSearch phone lookups are reliable. TruePeopleSearch phone lookups are best-effort, since that site puts its own extra check in front of full profile pages.

#### Can I run this on a schedule and only get changes?

Yes. Turn on incremental monitor mode and set up an Apify schedule. Each run only returns records that are new or changed since the last one.

#### Do I need my own API key from another service?

No. This Actor works on its own, unlike some alternatives that require you to bring your own third-party unlocking service account.

### 🔗 Other actors

- [Wyoming Business Search Scraper: Filings, Agent & Monitor](https://apify.com/getascraper/wyoming-business-registry-scraper) ↗ - Search Wyoming Secretary of State business filings by name or ID.
- [Startup investor contact database](https://apify.com/getascraper/startup-investor-contact-database) ↗ - Collect startup investor contact details for outreach.
- [Building Permit Lead Monitor: Chicago, NYC, Austin](https://apify.com/getascraper/construction-permit-lead-monitor) ↗ - Monitor new building permits as sales leads.
- [Capitol Trades Scraper: Congress Stock Trades & Monitor Mode](https://apify.com/getascraper/capitol-trades-scraper) ↗ - Track US Congress member stock trades with recurring monitoring.

# Actor input Schema

## `fullName` (type: `string`):

The person's full name to search for, e.g. "John Smith".

## `city` (type: `string`):

Optional city to narrow the search.

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

Optional two-letter state code to narrow the search, e.g. "NY".

## `sources` (type: `array`):

Which sites to search. Leave empty to search both.

## `includeDetails` (type: `boolean`):

Open each result's detail page for phone numbers. Slower and makes one extra request per result. FastPeopleSearch detail pages are reliable; TruePeopleSearch detail pages are best-effort and sometimes unavailable due to that site's own CAPTCHA gate.

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

Maximum number of person records to return.

## `onlyNewOrChanged` (type: `boolean`):

Only return records that are new or changed since your last run with the same monitor state name. Useful for periodically re-checking whether a person's known address or phone has changed.

## `stateName` (type: `string`):

Name for this run's incremental state, used only when 'Incremental monitor mode' is on. Use different names to track separate lookups independently.

## `requestDelayMs` (type: `integer`):

Pause between page loads to stay polite to the source sites.

## Actor input object example

```json
{
  "fullName": "John Smith",
  "city": "",
  "state": "",
  "sources": [],
  "includeDetails": false,
  "maxItems": 10,
  "onlyNewOrChanged": false,
  "stateName": "default",
  "requestDelayMs": 1000
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "fullName": "John Smith",
    "city": "",
    "state": "",
    "sources": [],
    "includeDetails": false,
    "maxItems": 10,
    "onlyNewOrChanged": false,
    "stateName": "default",
    "requestDelayMs": 1000
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/people-search-lookup-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 = {
    "fullName": "John Smith",
    "city": "",
    "state": "",
    "sources": [],
    "includeDetails": False,
    "maxItems": 10,
    "onlyNewOrChanged": False,
    "stateName": "default",
    "requestDelayMs": 1000,
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/people-search-lookup-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "fullName": "John Smith",
  "city": "",
  "state": "",
  "sources": [],
  "includeDetails": false,
  "maxItems": 10,
  "onlyNewOrChanged": false,
  "stateName": "default",
  "requestDelayMs": 1000
}' |
apify call getascraper/people-search-lookup-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/people-search-lookup-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/e9ztzdp2tILZgemTu/builds/vT3kfSZLQm4ShkpaY/openapi.json
