skip-trace

n8n community node for Skip Trace

Package Information

Downloads: 7 weekly / 50 monthly
Latest Version: 0.0.5
Author: ONEAPI

Documentation

n8n Nodes - Skip Trace(APIFY)

This n8n node enables you to locate hard-to-find individuals using Apify's powerful skip trace/tracing API. Connect TruePeopleSearch, Fastpeoplesearch, and other data sources to find people through n8n workflows.
This node integrates seamlessly with n8n workflows, allowing you to search for people using multiple methods: by name, name with address, address alone, phone number, or email address.

Apify is a platform for building, deploying, and publishing web automation tools called Actors, while n8n is a fair-code licensed workflow automation platform that connects various services and APIs.


Features

  • Multiple Search Methods: Search by name, name+address, address, phone number, or email
  • Comprehensive Results: Get detailed information including addresses, phone numbers, emails, relatives, associates, and more
  • Data Sources: Leverages TruePeopleSearch, Fastpeoplesearch, and other reliable data sources
  • Workflow Integration: Seamlessly integrate skip tracing into your n8n automation workflows

Search Options

The Skip Trace node supports multiple search methods:

1. Search by Name

Search using a full name, or combine name with city/state/zip for more precise results.

2. Search by Address

Search using street address combined with city, state, and zip code.

3. Search by Phone Number

Search using a phone number to find associated person information.

4. Search by Email Address

Search using an email address to locate associated individuals.


Input Parameters

Max Results From Each Search

  • Type: Integer (Optional)
  • Description: When you search for a name/address/phone, it finds many related persons. Set how many to scrape for each search.
  • Default: 1
  • Maximum: 10

Full Name

  • Type: Array (Optional)
  • Description: You can search by only 'name' or with '(name;citystatezip)'
  • Format:
    • Name only: "James E Whitsitt"
    • Name with location: "Amalia Castillo; Dallas, TX 75228"
  • Separator: Use semicolon (;) to separate name and location

Street and City/State/Zip

  • Type: Array (Optional)
  • Description: Enter Street and City/State/Zip separated by semicolon
  • Format: "3828 Double Oak Ln; Irving, TX 75061"
  • Separator: Use semicolon (;) to separate street and city/state/zip

Phone Number

  • Type: Array (Optional)
  • Description: Search by Phone Number
  • Format: "(214)349-3972" or "(956) 536-1441"

Email Address

  • Type: Array (Optional)
  • Description: Search by Email Address

Example Input

{
    "name": [
        "James E Whitsitt",
        "Amalia Castillo; Dallas, TX 75228"
    ],
    "street_citystatezip": [
        "3828 Double Oak Ln; Irving, TX 75061",
        "1171 S 2nd St; Cameron, TX 76520"
    ],
    "phone_number": [
        "(214)349-3972",
        "(956) 536-1441"
    ],
    "max_results": 1
}

Example Output

A single search result includes comprehensive information:

{
    "Search Option": "Name Search",
    "Input Given": "James E Whitsitt",
    "First Name": "James",
    "Last Name": "Whitsitt",
    "Age": "76",
    "Born": "February 1949",
    "Lives in": "1727 Summerlin Pl Jeffersonville IN 47130",
    "Street Address": "1727 Summerlin Pl",
    "Address Locality": "Jeffersonville",
    "Address Region": "IN",
    "Postal Code": "47130",
    "County Name": "Clark County",
    "Email-1": "goldiewhitsitt@hotmail.com",
    "Email-2": "janwhitsitt@att.net",
    "Email-3": "",
    "Email-4": "",
    "Email-5": "",
    "Phone-1": "(214) 534-2474",
    "Phone-1 Type": "Wireless",
    "Phone-1 Last Reported": "",
    "Phone-1 First Reported": "June 2024",
    "Phone-1 Provider": "New Cingular Wireless PCS LLC - IL",
    "Phone-2": "(812) 282-4071",
    "Phone-2 Type": "Landline",
    "Phone-2 Last Reported": "",
    "Phone-2 First Reported": "April 2014",
    "Phone-2 Provider": "Ameritech Indiana",
    "Phone-3": "(214) 538-7654",
    "Phone-3 Type": "Wireless",
    "Phone-3 Last Reported": "",
    "Phone-3 First Reported": "March 2014",
    "Phone-3 Provider": "New Cingular Wireless PCS LLC - IL",
    "Phone-4": "(972) 240-1643",
    "Phone-4 Type": "Landline",
    "Phone-4 Last Reported": "",
    "Phone-4 First Reported": "August 2010",
    "Phone-4 Provider": "Frontier Southwest Incorporated dba Frontier Communications of Texas",
    "Phone-5": "(860) 463-3190",
    "Phone-5 Type": "Wireless",
    "Phone-5 Last Reported": "",
    "Phone-5 First Reported": "September 2021",
    "Phone-5 Provider": "Cellco Partnership dba Verizon Wireless - CT",
    "Previous Addresses": [
        {
            "streetAddress": "928 Meadowcove Cir",
            "addressLocality": "Garland",
            "addressRegion": "TX",
            "postalCode": "75043",
            "county": "Dallas County",
            "timespan": "Recorded July 1989"
        },
        {
            "streetAddress": "428 Coleman St, Unit 25",
            "addressLocality": "Marlin",
            "addressRegion": "TX",
            "postalCode": "76661",
            "county": "Falls County",
            "timespan": "Recorded September 1986"
        },
        {
            "streetAddress": "13510 N Central Expy",
            "addressLocality": "Dallas",
            "addressRegion": "TX",
            "postalCode": "75243",
            "county": "Dallas County",
            "timespan": "Recorded August 2011"
        },
        {
            "streetAddress": "1727 Summerlin Pl",
            "addressLocality": "Jeffersonvlle",
            "addressRegion": "IN",
            "postalCode": "47130",
            "county": "Clark County",
            "timespan": "Recorded July 2010"
        }
    ],
    "Relatives": [
        {
            "Name": "Janice Whitsitt",
            "Age": "79"
        },
        {
            "Name": "Goldie Whitsitt",
            "Age": "75"
        },
        {
            "Name": "William Whitsitt",
            "Age": "79"
        }
    ],
    "Associates": [
        {
            "Name": "Lola Sonnenberg",
            "Age": "104"
        }
    ],
    "Person Link": "https://www.fastpeoplesearch.com/james-whitsitt_id_G-5782184243798810449"
}

Output Fields

The node returns comprehensive information including:

  • Basic Information: First name, last name, age, birth month/year
  • Current Address: Full address with street, city, state, zip, and county
  • Contact Information: Up to 5 email addresses and 5 phone numbers with types and providers
  • Historical Data: Previous addresses with timestamps
  • Relationships: Relatives and associates with ages
  • Source Link: Direct link to the source record

Setup

⚙️ Prerequisites

  • Node.js v23.11.1 or higher
  • An Apify account with API access
  • n8n installed (local or cloud)

Authentication

The node supports two authentication methods:

  1. API Key: Provide your Apify API token (for local n8n)
  2. OAuth2: Authenticate via OAuth2 (for n8n cloud)

Development

Start n8n with your custom node:

npm run build
npm run dev

This launches n8n at http://localhost:5678 with hot reloading enabled. Changes to your node files automatically refresh.


Getting Help


Note: This node requires valid Apify credentials to access the skip trace Actor. Make sure you have the necessary API access configured.

Discussion