# FamilyTreeNow Scraper - Relatives, Phones & Addresses (`memo23/familytreenow-scraper`) Actor

Search FamilyTreeNow.com by name, phone or street address and get one row per person: age, birth month, phones with line type and carrier, emails, current and past addresses with dates, every relative and associate with ages, work history and the home property record. No login needed.

- **URL**: https://apify.com/memo23/familytreenow-scraper.md
- **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community)
- **Categories:** Lead generation
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 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

## FamilyTreeNow Scraper - Relatives, Phones & Addresses

Turn names, phone numbers or street addresses into full US person records from FamilyTreeNow.com. Each row is one person with every listed phone number (line type, carrier, last-reported month, primary flag), email addresses, the current address with county and dates, past addresses with dates, the full list of relatives and associates with ages, other names, work history, businesses and the property record of the person's home.

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

### Why Use This Scraper?

- ✅ **Four ways in**: name (with city, state or ZIP), reverse phone, reverse address, or pasted FamilyTreeNow links
- ✅ **Family network first**: every relative and associate the record lists (often 20 to 30), each with age, birth month, a deceased flag and their own record link
- ✅ **Phone-rich records**: often 5 to 30 phones per person, each with Wireless / Landline / VoIP, the carrier, the last-reported month and the possible primary number
- ✅ **Dated addresses**: current address with county and date range, plus past addresses with county and dates
- ✅ **Home details**: value, equity, square feet, year built, last sale date, land use and parcel number of the current address
- ✅ **Narrow common names**: middle name, ZIP code and birth year filters
- ✅ **Batch lookups**: up to 1,000 names, phones or addresses in one run, with a per-lookup cap
- ✅ **Spreadsheet columns**: optional Email-1 to Email-5 and Phone-1 to Phone-5 columns for CSV and Excel
- ✅ **No setup**: no login, no account and no API key needed

### Overview

FamilyTreeNow Scraper is for skip tracers, genealogists, real-estate investors, collections teams and researchers who need structured US people data from FamilyTreeNow.com without copying it by hand.

Whatever you start from, the output is person-shaped: one row per person. A name search returns the people the site lists for that name and place (people who live there now or lived there before); a phone lookup returns the people tied to that number; an address lookup returns the people linked to that address.

With **Full person records** on (the default) every person's record is opened and read in full. Turn it off for fast summary rows with name, age, birth month, city, past cities and the first few relatives.

### Supported Inputs

#### Lookups

| Lookup | Fields | Example |
|---|---|---|
| Name in a city | `firstName`, `lastName`, `city`, `state` | John Smith, Dallas, TX |
| Name in a state | `firstName`, `lastName`, `state` | John Smith, TX |
| Name in a ZIP code | `firstName`, `lastName`, `zip` | John Smith, 75243 |
| Name anywhere in the US | `firstName`, `lastName` | John Smith |
| Narrower name search | add `middleName`, `birthYear` | John K Smith, born 1985 |
| Reverse phone | `phone` | (214) 555-0147 |
| Reverse address | `address` with `city` + `state`, or with `zip` | 177 Main St, Bastrop, TX |

A filled phone number runs a phone lookup; a filled street address (with no phone) runs an address lookup; otherwise the name search runs. A city only narrows a name search together with a state.

#### FamilyTreeNow links

Paste links into **Links** instead of filling the fields:

```json
{
  "startUrls": [
    { "url": "https://www.familytreenow.com/search/people/results?first=John&last=Smith&citystatezip=Dallas,%20TX" },
    { "url": "https://www.familytreenow.com/search/people/results?phoneno=2145550147" },
    { "url": "https://www.familytreenow.com/search/people/results?first=Andrew&middle=Lane&last=Smith&personid=gtonrlrraporlpeptele" }
  ]
}
```

People search results, "All Records" results, phone and address results, later result pages (`&page=2`) and person records (a "View Details" link, or a relative's link) all work. Links from other sites are skipped with a note in the log.

#### Moving over from another people-search tool?

The input names `name` ("Full Name" or "Full Name; City, ST ZIP"), `street_citystatezip` ("123 Main St; City, ST ZIP"), `phone_number` and `max_results` are read as lookups too, so existing JSON keeps working. FamilyTreeNow has no email lookup, so an `email` entry is skipped with a note.

### Use Cases

- **Skip tracing**: find current phones for property owners, debtors or missing contacts
- **Genealogy and family research**: map a person's relatives with ages, birth months and who is deceased
- **Real-estate outreach**: look up everyone linked to an address, with the home's value and last sale date
- **Reverse phone checks**: see who a number belongs to, what line type it is and where they live
- **Lead enrichment**: add phones, address history, employer and businesses to a list of names

### How It Works

1. You give one lookup, a list of lookups, or FamilyTreeNow links.
2. The actor opens the result pages for each lookup and walks to the next page until your limits are reached.
3. With full records on, it opens each person's record and reads phones, emails, addresses, relatives, associates, other names, work history, businesses and the property record.
4. Each person is written as one dataset row. A person found by two lookups is returned once.

### Input Configuration

| Field | Type | Default | What it does |
|---|---|---|---|
| `firstName`, `lastName` | string | John, Smith (prefill) | Name to look up |
| `middleName` | string | | Optional middle name or initial |
| `city`, `state` | string | Dallas, TX (prefill) | Narrow a name search; used for an address lookup |
| `zip` | string | | Narrows a name search, or completes an address lookup |
| `birthYear` | integer | | Keeps people born in that year |
| `phone` | string | | Reverse phone lookup |
| `address` | string | | Reverse address lookup |
| `searches` | array | | Many lookups in one run, each with the fields above |
| `maxItemsPerSearch` | integer | 3 with several searches | Most people kept per lookup (person links are one person each and do not count) |
| `startUrls` | array | | FamilyTreeNow links; replaces the lookups |
| `openProfiles` | boolean | true | Full person records (off = summary rows) |
| `flattenedOutput` | boolean | false | Adds Email-1 / Phone-1 style columns |
| `maxItems` | integer | 10 | Most people per run (3,000 cap; 25 on the free plan) |
| `maxConcurrency` | integer | 5 | Pages loaded at the same time |

#### Common scenarios

One person in one city:

```json
{ "firstName": "Mary", "lastName": "Johnson", "city": "Chicago", "state": "IL", "maxItems": 10 }
```

A batch of lookups, two people each:

```json
{
  "searches": [
    { "firstName": "Jane", "lastName": "Doe", "city": "Austin", "state": "TX" },
    { "name": "John K Smith", "zip": "78602", "birthYear": 1985 },
    { "phone": "214-555-0147" },
    { "address": "177 Main St", "city": "Bastrop", "state": "TX" }
  ],
  "maxItemsPerSearch": 2,
  "maxItems": 50
}
```

### Output Overview

One row per person. Nested fields keep the full detail (every phone with its type and carrier, every address with dates, every relative with age); turn on **Spreadsheet columns** for flat columns as well. Export as JSON, CSV, Excel or through the Apify API.

### Output Samples

A full record, trimmed (values changed):

```json
{
  "type": "person",
  "recordId": "hyCCrUL-eUndg2fBrVsxkQ",
  "profileUrl": "https://www.familytreenow.com/search/people/results?first=John&last=Smith&citystatezip=Dallas,%20TX&rid=asl",
  "fullName": "John Smith",
  "firstName": "John",
  "middleName": null,
  "lastName": "Smith",
  "age": 41,
  "bornMonthYear": "Oct 1985",
  "birthYear": 1985,
  "deceased": false,
  "currentAddress": {
    "fullAddress": "177 Main St, Bastrop, TX 78602",
    "street": "177 Main St",
    "city": "Bastrop",
    "state": "TX",
    "zip": "78602",
    "county": "Bastrop County",
    "dateRange": "May 2004 - Oct 2026",
    "firstSeen": "May 2004",
    "lastSeen": "Oct 2026",
    "propertySummary": "$344,000 | 1396 Sq Ft | Built 2003"
  },
  "pastAddresses": [
    { "fullAddress": "1071 E Center Rd #2212, Garland, TX 75041", "county": "Dallas County", "dateRange": "Feb 2006 - Jul 2006", "firstSeen": "Feb 2006", "lastSeen": "Jul 2006" }
  ],
  "phones": [
    { "number": "(214) 555-0147", "type": "Wireless", "carrier": "AT&T", "lastReported": "Oct 2026", "isPrimary": true },
    { "number": "(512) 555-0198", "type": "Landline", "carrier": "Southwestern Bell Telephone Company", "lastReported": "Sep 2023", "isPrimary": false }
  ],
  "primaryPhone": "(214) 555-0147",
  "emails": ["jsmith.example@hotmail.com"],
  "currentEmail": "jsmith.example@hotmail.com",
  "relatives": [
    { "name": "Andrew Lane Smith", "age": 48, "bornMonthYear": "Mar 1978", "deceased": false, "profileUrl": "https://www.familytreenow.com/search/people/results?first=Andrew&middle=Lane&last=Smith&personid=gtonrlrraporlpeptele" },
    { "name": "Kenneth E Smith", "age": null, "bornMonthYear": null, "deceased": true, "profileUrl": "https://www.familytreenow.com/search/people/results?first=Kenneth&middle=E&last=Smith&personid=gollnplpkulnuapktkol" }
  ],
  "associates": [{ "name": "Betty Jean Johnson", "age": 68, "bornMonthYear": "Apr 1958", "deceased": false, "profileUrl": "https://www.familytreenow.com/search/people/results?first=Betty&middle=Jean&last=Johnson&personid=gsutlutrnlpetlkakenkk" }],
  "akas": ["Jonathon K Smith", "Johnathan K Smith"],
  "employment": [{ "company": "4tp Backhoe Service", "jobTitle": "Business Owner", "duration": null, "industry": null }],
  "businesses": [],
  "property": { "Sq Ft": "1,396", "Year Built": "2003", "Aprox. Value": "$344,000", "Last Sale Date": "11/03/2005", "Land Use": "Single Family", "APN": "R00000" },
  "detailsFetched": true,
  "source": "familytreenow",
  "searchedAt": "2026-11-14T08:41:05.465Z",
  "query": { "searchMode": "name", "firstName": "John", "lastName": "Smith", "city": "Dallas", "state": "TX", "inputGiven": "John Smith, Dallas, TX" }
}
```

### Key Output Fields

#### Identity

`fullName`, `firstName`, `middleName`, `lastName`, `age`, `bornMonthYear`, `birthYear`, `deceased`, `akas`, `recordId`, `profileUrl`

#### Phones

`phones[]` with `number`, `type` (Wireless, Landline, VoIP), `carrier`, `lastReported`, `isPrimary`, `reverseLookupUrl`; `primaryPhone`

#### Emails

`emails[]`, `currentEmail`

#### Addresses

`currentAddress` (street, city, state, zip, county, dateRange, firstSeen, lastSeen, propertySummary), `pastAddresses[]` (with `county`, `dateRange`, `firstSeen`, `lastSeen`)

#### Family and people network

`relatives[]` and `associates[]`, each with `name`, `age`, `bornMonthYear`, `deceased`, `profileUrl`

#### Work, businesses and home

`employment[]` with `company`, `jobTitle`, `duration`, `industry`; `businesses[]` with `name` and `address`; `property` with the home's record

#### Run fields

`detailsFetched` (true for a full record), `source`, `searchedAt`, `query` (the lookup that found the person)

### FAQ

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

Free-plan runs use the first lookup, return up to 25 people as summary rows (name, age, birth month, city, past cities and some relatives), and hide part of the contact fields. Any paid Apify plan returns full records.

#### What does a full record cost compared with a summary row?

Every row is one dataset item. A row whose record was read in full is also counted as a full-record event. Turn **Full person records** off to get summary rows only.

#### Are emails always present?

No. FamilyTreeNow lists emails for some people only; `emails` is an empty list when none are shown. Phones, addresses and relatives are on almost every record.

#### Why does a search for Dallas return people living elsewhere?

FamilyTreeNow lists everyone who lives in the place now or lived there before. `currentAddress` shows where the person lives today and `pastAddresses` shows the Dallas address.

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

The site shows up to 250 people per search (25 pages of 10). Narrow it with a city, ZIP, middle name or birth year, or cap it with `maxItemsPerSearch` and `maxItems`.

#### Can I search by email?

No. FamilyTreeNow has no email search; use a name, phone number or street address.

#### What if a person's record does not load?

The actor retries it. If it still does not load, the person is returned as a summary row with `detailsFetched: false` and a `detailsNote`.

#### Can I get private or paywalled data?

No. The actor reads what FamilyTreeNow shows publicly. It does not sign in or open paid reports.

### Support

Found a bug or need a field that is missing? Open an issue on the actor's Issues tab and include the run link.

### Additional Services

Need a custom people-search pipeline, a different source, or data delivered to your CRM? Get in touch through the Issues tab.

### Explore More Scrapers

- [FastPeopleSearch Scraper](https://apify.com/memo23/fastpeoplesearch-scraper): phones, emails and addresses from FastPeopleSearch.com
- [AdvancedBackgroundChecks Scraper](https://apify.com/memo23/advancedbackgroundchecks-scraper): phones, emails and dated addresses from AdvancedBackgroundChecks.com
- [TruePeopleSearch People Search Scraper](https://apify.com/memo23/truepeoplesearch-people-search-scraper): US people records from TruePeopleSearch.com

### 🤖 For AI Agents & LLM Apps

This actor works as a tool for agents and MCP clients.

- **Input**: `{ "firstName": "...", "lastName": "...", "city": "...", "state": "XX", "maxItems": 5 }`, or `{ "phone": "..." }`, or `{ "address": "...", "city": "...", "state": "XX" }`
- **Output**: one JSON object per person; read `phones[].number`, `currentAddress.fullAddress`, `relatives[].name` and `emails`
- **Tips**: keep `maxItems` small for interactive use; check `detailsFetched` before relying on phones; add `birthYear` or `zip` to pin down a common name

### ⚠️ Disclaimer

This actor collects data that FamilyTreeNow.com shows publicly. It is not affiliated with or endorsed by FamilyTreeNow. You are responsible for how you use the data: comply with the site's terms, the FCRA, TCPA, DPPA, GDPR, CCPA and every other law that applies to you. Do not use this data to decide on credit, insurance, employment, housing or tenancy, or for any purpose covered by the FCRA. Do not use it to stalk, harass or harm anyone.

### SEO Keywords

familytreenow scraper, familytreenow.com scraper, familytreenow api, family tree now people search, people search scraper, relatives lookup, genealogy records scraper, reverse phone lookup, reverse address lookup, skip tracing tool, find phone number by name, us people search api, address history lookup, family members finder, people finder api

# Actor input Schema

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

First name of the person. Use it with Last name; City and State (or a ZIP code) narrow the results.

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

Last name of the person.

## `middleName` (type: `string`):

Optional middle name or initial. Leave empty unless the first and last name return too many people.

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

Optional. Narrows a name search to one city (needs State). Used with State for an address lookup.

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

Two-letter US state. Narrows a name search; used with City for an address lookup.

## `phone` (type: `string`):

Find who a US phone number belongs to. Any format works, e.g. (214) 708-6530. When filled, this lookup runs instead of the name search.

## `address` (type: `string`):

Find the people linked to a street address, e.g. 177 Cynthia Dr. Needs City and State, or a ZIP code. When filled (and no phone is given), this lookup runs instead of the name search.

## `zip` (type: `string`):

Optional 5-digit ZIP code. Narrows a name search on its own, or completes an address lookup.

## `birthYear` (type: `integer`):

Optional. Keeps people born in that year.

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

One object per lookup, each with the same fields as above: {"firstName":"Jane","lastName":"Doe","city":"Austin","state":"TX"}, {"phone":"2147086530"} or {"address":"123 Main St","city":"Austin","state":"TX"}. A full name in "name" and "middleName", "zip" and "birthYear" also work. When set, it replaces the single lookup above. Up to 1,000 lookups per run on a paid plan.

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

Most people kept from each lookup. Defaults to 3 when you run more than one search, so a common name does not use up the whole run. Person links are one person each and do not count.

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

FamilyTreeNow search result pages or person record pages.

## `openProfiles` (type: `boolean`):

On: opens each person's record for every phone number (with line type, carrier, last-reported date and primary flag), emails, current address with county and dates, past addresses, all relatives and associates with ages, other names, work history, businesses and the home's property record. Off: faster rows with name, age, birth month, city, past cities and some relatives only.

## `flattenedOutput` (type: `boolean`):

Adds flat columns (Email-1 to Email-5, Phone-1 to Phone-5 with type, carrier and last-reported date, Street Address, City, State, Postal Code) next to the nested fields, for CSV and Excel exports.

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

Most people returned by the run. One run returns at most 3,000 (25 on the free Apify plan).

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

How many pages load at the same time.

## Actor input object example

```json
{
  "firstName": "John",
  "lastName": "Smith",
  "city": "Dallas",
  "state": "TX",
  "openProfiles": true,
  "flattenedOutput": false,
  "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",
    "city": "Dallas",
    "state": "TX",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("memo23/familytreenow-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",
    "city": "Dallas",
    "state": "TX",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("memo23/familytreenow-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",
  "city": "Dallas",
  "state": "TX",
  "maxItems": 10
}' |
apify call memo23/familytreenow-scraper --silent --output-dataset

```

## MCP server setup

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