# SearchPeopleFree Scraper - People Search: Phones & Emails (`memo23/searchpeoplefree-scraper`) Actor

Search SearchPeopleFree.com by name, state and city, or run 1,000 name searches at once. Each row is one person with every phone number and line type, full email addresses, current and past addresses with dates, relatives, spouse, associates, aliases, age and work history. Export JSON or CSV.

- **URL**: https://apify.com/memo23/searchpeoplefree-scraper.md
- **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community)
- **Categories:** Lead generation
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 person founds

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SearchPeopleFree Scraper - People Search: Phones & Emails

Search **SearchPeopleFree.com** by name (with or without state and city), run up to 1,000 name searches in one go, or paste SearchPeopleFree links. Every row is one person: all phone numbers with line type, **full email addresses**, current and past street addresses with dates, relatives (spouse marked), associates, aliases, age and work history.

![How SearchPeopleFree Scraper works](https://raw.githubusercontent.com/muhamed-didovic/muhamed-didovic.github.io/main/assets/how-it-works-searchpeoplefree.png)

### Why Use This Scraper?

- **Full records, not just the results list.** Each person's full record is opened, so you get every phone and email, not the two or three the list shows.
- **Complete email addresses.** The site shows emails half hidden; rows carry the whole address.
- **Bulk name lookups.** Up to 1,000 searches per run, each with its own per-search cap, so one common name cannot eat the whole run.
- **Clean, one-person rows.** No duplicates across searches; family and associates kept in separate lists; dates in ISO format.
- **No setup.** No accounts, keys or extra configuration.

### Overview

| | |
|---|---|
| Site | searchpeoplefree.com (US people search) |
| Inputs | first + last name, optional state and city; a list of searches; SearchPeopleFree links |
| Output | one row per person (JSON, CSV, Excel, API) |
| Main fields | name, age, birth years, phones + line type, emails, current address with coordinates, past addresses with dates, relatives, associates, aliases, employment |

### Supported Inputs

#### Name search

| Field | Required | Example |
|---|---|---|
| `firstName` | yes | `John` |
| `lastName` | yes | `Smith` |
| `state` | no | `TX` or `Texas` |
| `city` | no (needs a state) | `Austin` |

#### Links (`startUrls`)

- Results pages: `https://www.searchpeoplefree.com/find/john-smith/tx/austin`, `https://www.searchpeoplefree.com/find/john-smith/tx`, `https://www.searchpeoplefree.com/find/john-smith`, and later pages such as `.../p-3`
- Person pages: `https://www.searchpeoplefree.com/find/john-smith/259sXBk9IUq0`

#### Not supported

Phone, address and email lookups, and links to other sites. Entries that cannot be searched are listed in the log and skipped.

### Use Cases

- **Skip tracing**: find current phones and addresses for a list of names.
- **Lead enrichment**: add phones and emails to a CRM list of people.
- **Identity checks**: confirm age, aliases and address history of a contact.
- **Genealogy and reunions**: map relatives and past addresses.
- **Research**: build datasets of public US people-search records.

### How It Works

1. You give names (or links).
2. The actor reads the results pages for each search until your limit, skipping people already returned.
3. With **Open each person's full record** on (default), it opens every person's record and reads all phones, emails, addresses, relatives, associates and jobs.
4. Each person is saved as one row as soon as it is ready.

### Input Configuration

| Field | Type | Default | Description |
|---|---|---|---|
| `firstName`, `lastName` | string | John / Smith (prefill) | Person to find |
| `state` | string | TX (prefill) | Two-letter code or full name |
| `city` | string | Austin (prefill) | Needs a state |
| `matchFirstName` | boolean | `true` | Skip people who share only the last name with your search (not charged) |
| `searches` | array | | `[{"firstName":"Jane","lastName":"Doe","state":"CA","city":"San Diego"}]`; replaces the single search |
| `startUrls` | array | | SearchPeopleFree links; replace all searches |
| `includeContactDetails` | boolean | `true` | Open each person's full record (phones, emails, street addresses) |
| `maxItems` | integer | `10` | Most people per run (max 3,000) |
| `maxItemsPerSearch` | integer | | Most people per search; left empty with several searches, each gets an even share of maxItems and unused shares pass to later searches |
| `maxConcurrency` | integer | `5` | Full records opened at the same time (1-10) |

#### Common scenarios

One person in a city:

```json
{ "firstName": "John", "lastName": "Smith", "state": "TX", "city": "Austin", "maxItems": 10 }
```

A list of people:

```json
{
  "searches": [
    { "firstName": "Jane", "lastName": "Doe", "state": "CA", "city": "San Diego" },
    { "firstName": "Robert", "lastName": "Brown", "state": "FL" }
  ],
  "maxItemsPerSearch": 3,
  "maxItems": 100
}
```

Results list only (cheaper, no phones or emails):

```json
{ "firstName": "Maria", "lastName": "Garcia", "state": "FL", "includeContactDetails": false, "maxItems": 50 }
```

### Output Overview

One row per person. With full records on, rows have `detailsFetched: true` and carry phones, emails and street addresses. Rows from the results list only (`detailsFetched: false`) carry name, age, current and past cities, aliases and the relatives and associates the list shows.

### Output Samples

Trimmed, with made-up contact values:

```json
{
  "type": "person",
  "personId": "259sXBk9IUq0",
  "profileUrl": "https://www.searchpeoplefree.com/find/john-smith/259sXBk9IUq0",
  "fullName": "John Smith",
  "firstName": "John",
  "middleName": null,
  "lastName": "Smith",
  "age": 46,
  "birthYears": "1980 or 1979",
  "birthYear": 1980,
  "deceased": false,
  "aliases": ["Johnny Smith", "John A Smith"],
  "currentAddress": {
    "fullAddress": "100 Example St, Austin, TX 78701",
    "street": "100 Example St",
    "city": "Austin",
    "state": "TX",
    "zip": "78701",
    "latitude": 30.2672,
    "longitude": -97.7431,
    "reportedDate": null,
    "addressUrl": "https://www.searchpeoplefree.com/address/tx/austin/example-st/100"
  },
  "pastAddresses": [
    { "fullAddress": "200 Sample Dr, Cedar Park, TX 78613", "street": "200 Sample Dr", "city": "Cedar Park", "state": "TX", "zip": "78613", "reportedDate": "2025-08-31" }
  ],
  "phones": [
    { "number": "(512) 555-0101", "type": "Wireless", "carrier": null, "reportedDate": "2026-10-01", "isPrimary": true },
    { "number": "(512) 555-0102", "type": "Landline", "carrier": null, "reportedDate": "2026-07-24", "isPrimary": false }
  ],
  "primaryPhone": "(512) 555-0101",
  "phoneCount": 2,
  "emails": ["john.smith@example.com"],
  "emailCount": 1,
  "relatives": [{ "name": "Jane Smith", "relation": "Spouse", "profileUrl": "https://www.searchpeoplefree.com/find/jane-smith/13cTTUXYE8bJ" }],
  "associates": [{ "name": "Mark Example", "relation": null, "profileUrl": "https://www.searchpeoplefree.com/find/mark-example/13IGiwI0RLsk" }],
  "spouse": "Jane Smith",
  "employment": [{ "title": "ASSISTANT CONTROLLER", "location": "Austin, TX" }],
  "recordConfirmedAt": "2026-11-12",
  "detailsFetched": true,
  "source": "searchpeoplefree",
  "searchUrl": "https://www.searchpeoplefree.com/find/john-smith/tx/austin",
  "query": { "kind": "name", "firstName": "John", "lastName": "Smith", "city": "Austin", "state": "TX", "inputGiven": "John Smith, Austin, TX" },
  "scrapedAt": "2026-11-13T16:40:00.000Z"
}
```

### Key Output Fields

#### Identity

`fullName`, `firstName`, `middleName`, `lastName`, `age`, `birthYears`, `birthYear`, `deceased`, `aliases`, `personId`, `profileUrl`

#### Phones

`phones[]` with `number`, `type` (Wireless, Landline, VoIP), `reportedDate` (month last reported), `isPrimary`; `primaryPhone`; `phoneCount`. SearchPeopleFree does not list carriers, so `carrier` is always `null`.

#### Emails

`emails[]` (full addresses), `emailCount`

#### Addresses

`currentAddress` (street, city, state, zip, latitude, longitude), `pastAddresses[]` with `reportedDate`

#### People network

`relatives[]` (with `relation: "Spouse"` where listed), `associates[]`, `spouse`

#### Work

`employment[]` with `title` and `location`. Employer names are hidden on the site and are not returned.

#### Run context

`detailsFetched`, `searchUrl`, `query` (your input that found the person), `recordConfirmedAt`, `scrapedAt`

### FAQ

#### What do I get on the free Apify plan?

One search and up to 25 people per run, from the results list (name, age, city, past cities, relatives), with contact fields partly hidden. Any paid Apify plan returns full records.

#### What am I charged for?

Each person row is one result. Rows whose full record was opened also count one "person details" event. Searches that find nobody cost nothing beyond the run start, and people skipped by **Only people with that first name** are not charged. A person link (`https://www.searchpeoplefree.com/find/john-smith/259sXBk9IUq0`) is that person's full record, so it always counts the details event, even with **Open each person's full record** off.

#### Why does a row have no phones?

Either full records were turned off, or that person's record could not be loaded during the run (the row then has `detailsFetched: false` and is not charged the details event). Running the same input again usually fills it.

#### Why did a search return nobody, or fewer people than the site shows?

When SearchPeopleFree has nobody with the first name you searched, it lists other people with the same last name instead. With **Only people with that first name** on (default), those people are skipped and you are not charged for them; the log says how many were skipped. A person still counts when their name or an alias carries your first name (Rob matches Robert). Turn the option off to get everyone the site lists.

#### How many people can one name return?

The site lists up to 250 people per search (25 pages). Add a state and city to narrow a common name.

#### Are emails complete?

Yes. Rows carry the full address, not the half-hidden version shown on the page.

#### Can I search by phone or address?

Not in this actor. Name searches and SearchPeopleFree links only.

### Support

Found a bug or need a field? Open an issue on the actor's Issues tab, or email **muhameddidovic@gmail.com**.

### Additional Services

Need a custom export, scheduled monitoring, or the same data from another people-search site? Email **muhameddidovic@gmail.com**.

### Explore More Scrapers

- [**FastPeopleSearch Scraper**](https://apify.com/memo23/fastpeoplesearch-scraper) - names, phones and addresses with decoded emails
- [**TruePeopleSearch Scraper**](https://apify.com/memo23/truepeoplesearch-people-search-scraper) - US people search on TruePeopleSearch.com

Full list at [apify.com/memo23](https://apify.com/memo23).

### 🤖 For AI Agents & LLM Apps

Actor: `memo23/searchpeoplefree-scraper`.

**Purpose:** US people search on SearchPeopleFree.com by name (optional state/city), in bulk or from links; one row per person with phones, full emails, addresses, relatives and associates.

**Minimal input:**

```json
{ "firstName": "John", "lastName": "Smith", "state": "TX", "city": "Austin", "maxItems": 5 }
```

**Batch input:**

```json
{ "searches": [{ "firstName": "Jane", "lastName": "Doe", "state": "CA" }, { "firstName": "Robert", "lastName": "Brown", "state": "FL", "city": "Miami" }], "maxItemsPerSearch": 2, "maxItems": 10 }
```

**Behaviors to know:**

- Always set `maxItems`; with several searches also set `maxItemsPerSearch`.
- `startUrls` replaces `searches`, which replaces the single search fields.
- `includeContactDetails: false` returns results-list rows only (no phones or emails).
- `matchFirstName` (default `true`) skips people who share only the last name; set `false` to get everyone the site lists.
- Expect a few seconds per person with full records on.

***

### ⚠️ Disclaimer

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by SearchPeopleFree.com or its operators. All trademarks are the property of their respective owners.

It reads only publicly available people-search pages, with no login and no paid features. People-search data is sensitive: you are responsible for using it in line with SearchPeopleFree.com's Terms of Service, the Fair Credit Reporting Act (this actor is not a consumer reporting agency; do not use its output for employment, credit, insurance or tenancy decisions), applicable privacy law (CCPA, GDPR and others) and anti-harassment laws.

***

### SEO Keywords

searchpeoplefree scraper, searchpeoplefree API, searchpeoplefree.com scraper, scrape searchpeoplefree, people search scraper, people finder API, find phone number by name, email finder by name, skip tracing tool, skip trace data, reverse people lookup, US public records scraper, address history data, relatives and associates data, contact enrichment, lead generation people data, background check data, fastpeoplesearch alternative, truepeoplesearch alternative

# Actor input Schema

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

First name of the person.

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

Last name of the person.

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

US state, two-letter code or full name (TX or Texas). Optional, but it narrows a common name a lot.

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

City within the state. Optional; needs a state.

## `matchFirstName` (type: `boolean`):

On: when SearchPeopleFree has nobody with the first name you searched, it lists other people who share the last name; those are skipped and not charged. A person counts as a match when their name or an alias has your first name (Rob also matches Robert, Chris also matches Christopher). Off: every person the site lists is returned. Applies to name searches and results-page links.

## `searches` (type: `array`):

One object per person to look up, each with firstName, lastName and optionally state and city. When this list is set it replaces the single search above. Up to 1,000 lookups per run. Example: \[{"firstName":"Jane","lastName":"Doe","state":"CA","city":"San Diego"},{"firstName":"Robert","lastName":"Brown","state":"FL"}]

## `startUrls` (type: `array`):

Name search links (https://www.searchpeoplefree.com/find/john-smith/tx/austin, later pages too) or person links (https://www.searchpeoplefree.com/find/john-smith/259sXBk9IUq0). When set, these replace the searches above.

## `includeContactDetails` (type: `boolean`):

On: every person gets their full record with all phone numbers and line types, full email addresses, street addresses with dates, every relative and associate, and work history. Off: rows hold only what the results list shows (name, age, city, past cities, some relatives) and cost less. A person link is always read as a full record.

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

Most people returned by the run (at most 3,000). Common names can match hundreds of people.

## `maxItemsPerSearch` (type: `integer`):

Most people kept for each name search. Left empty with several searches, each search gets an even share of Maximum people, and a search that finds fewer passes its unused share on to the searches after it, so one common name cannot use up the whole run.

## `maxConcurrency` (type: `integer`):

How many full records are opened at the same time (1 to 10).

## Actor input object example

```json
{
  "firstName": "John",
  "lastName": "Smith",
  "state": "TX",
  "city": "Austin",
  "matchFirstName": true,
  "includeContactDetails": true,
  "maxItems": 10,
  "maxConcurrency": 5
}
```

# Actor output Schema

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

Dataset of person 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 = {
    "firstName": "John",
    "lastName": "Smith",
    "state": "TX",
    "city": "Austin"
};

// Run the Actor and wait for it to finish
const run = await client.actor("memo23/searchpeoplefree-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 = {
    "firstName": "John",
    "lastName": "Smith",
    "state": "TX",
    "city": "Austin",
}

# Run the Actor and wait for it to finish
run = client.actor("memo23/searchpeoplefree-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 '{
  "firstName": "John",
  "lastName": "Smith",
  "state": "TX",
  "city": "Austin"
}' |
apify call memo23/searchpeoplefree-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,memo23/searchpeoplefree-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/tbQmYbj8QlF30VvSx/builds/lr8qQIUScRMEk0rsm/openapi.json
