USPhonebook People Search Scraper

Scrapes US people records from USPhonebook.com by name, optionally narrowed by state. Returns full name, current and past addresses, known relatives, and a direct profile link as clean JSON.

---

USPhonebook Scraper Features

• Name search with an optional state filter — hand it a first and last name and get the matching people.
• Returns up to 10 people per search, each with their own addresses and relatives.
• Captures both current and past addresses as separate fields, which is the part skip-tracers actually care about.
• Lists known relatives per person, useful for confirming you have the right individual.
• Gives you a direct profile link for every record, so you can verify any row at the source.
• Caps output with maxItems. You pay for what you pull.

---

Who Uses People Search Data?

• Skip tracers — Turn a name into last-known addresses and a relative network without a paid investigator subscription.
• Collections and recovery teams — Build contactable records from sparse inputs, or at least the dataset that makes outreach possible.
• Fraud and identity analysts — Cross-check a claimed name against listed addresses and relatives.
• Process servers and legal support — Confirm a current address before sending someone to knock on a door.
• Researchers and genealogists — Trace address history and family connections across states.

---

How USPhonebook Scraper Works

1. Give it a first and last name, optionally narrowed by state.
2. The scraper fetches the matching results page.
3. Extracts each person — name, current address, past addresses, relatives, profile link.
4. Returns clean JSON, capped at maxItems.

---

Input

Name search (with optional state):

{
  "searchMode": "name",
  "firstName": "Jane",
  "lastName": "Doe",
  "state": "California",
  "maxItems": 10
}

Name search (all states):

{
  "searchMode": "name",
  "firstName": "Jane",
  "lastName": "Doe",
  "maxItems": 10
}

---

Output

Each record is one person from the results page:

{
  "fullName": "John James Smith",
  "currentAddress": "Homosassa, FL",
  "pastAddresses": ["Auburn, NY", "Owasco, NY", "Merrick, NY"],
  "relatives": ["Julie Smith", "Carolyn Smith", "Connor Smith"],
  "profileUrl": "https://www.usphonebook.com/john-smith/U5ITN3QTOyEzM2EzNzUTN1cjM30yR",
  "source": "usphonebook",
  "scrapedAt": "2026-09-14T15:46:36.650Z"
}

Field	Description
fullName	Full name of the person
currentAddress	Most recent listed address, as City, ST
pastAddresses	Previously listed addresses
relatives	Names of known relatives
profileUrl	Direct link to the person's USPhonebook profile page
source	Always usphonebook
scrapedAt	ISO-8601 timestamp of when the record was scraped

---

Notes

This scraper does not return phone numbers. USPhonebook does not publish them to visitors who are not signed in, so there is no phone number for the scraper to read. Reverse-phone lookup was removed for the same reason: a search by number could only ever return a record with no number in it. If you need phone data, this is not the right source.