Spokeo People Search Scraper

Search for people by name and US state on Spokeo's public directory. Returns full names, all known addresses (street, city, state, ZIP), name variants, profile URLs, and related persons. City-level pagination delivers 100+ unique results per name-state query.

What it does

Submit a first name, last name, and US state. The actor queries Spokeo's public state directory, walks up to 10 metro/city sub-pages per query for expanded coverage, and returns structured person records without requiring a login or API key.

Each record includes:

• Full name and age
• Name variants (also known as aliases)
• Current city and state of residence
• Historical locations (lived in)
• Related persons (family members listed on the public record)
• Address array with city, state, and ZIP parsed from the listing
• Canonical Spokeo profile URL for follow-up research
• Source identifier and scrape timestamp

Use cases

• Skip tracing — locate current or historical address data for a known name + state combination
• Due diligence — verify address history for real estate, legal, or debt recovery workflows
• OSINT research — surface publicly listed name variants, relatives, and location history
• Contact verification — confirm that a person's stated address matches public records

Input

Field	Type	Required	Default	Description
firstName	string	Yes	John	First name to search
lastName	string	Yes	Smith	Last name to search
state	string	Yes	California	Full US state name (e.g. California, Texas, New York)
maxCities	integer	No	10	Maximum city sub-pages to crawl. Each yields ~30 results.
maxItems	integer	No	10	Maximum person records to return. Set to 0 for unlimited.

Resuming a large crawl

Every run emits a resumeCursor in its Output. If a large crawl stops before it finishes — because it hit maxItems, your spend cap (maxTotalChargeUsd), or was aborted — start a new run with the same input plus that resumeCursor to continue from where it left off. The crawl resumes from the queued work the previous run didn't reach.

• You are not re-charged for records the earlier run already delivered.
• Resume within your account's run-retention window — on the free tier, roughly your 10 most recent runs. Once the source run is pruned, its resumeCursor is no longer valid.
• resumeCursor is opaque — supply it unmodified.

Output

Results are saved to the default dataset. Example record:

{
  "fullName": "John Smith",
  "age": 70,
  "nameVariants": ["John N Smith"],
  "residesIn": "San Diego, CA",
  "livedIn": ["Bremerton WA", "La Mesa CA"],
  "relatedTo": ["Barbara Smith-Tenorio", "Mitchell Smith"],
  "addresses": [
    {
      "city": "San Diego",
      "state": "CA",
      "zip": "",
      "fullAddress": "San Diego, CA"
    }
  ],
  "profileUrl": "https://www.spokeo.com/John-Smith/California/San-Diego/p2017030807173912183292855803273",
  "firstName": "John",
  "lastName": "Smith",
  "state": "California",
  "source": "spokeo",
  "scrapedAt": "2026-05-27T20:24:53.429Z"
}

Notes

• Public records only — Spokeo's state directory pages are publicly accessible without login. This actor scrapes only data visible to any unauthenticated visitor.
• Address granularity — listing pages show city + state. Street-level addresses appear only behind Spokeo's paywall (not scraped by this actor).
• City pagination — Spokeo caps state-level results at ~30. The actor walks metro/city sub-pages (up to maxCities) to lift practical coverage to 100+ unique persons per query.
• No proxy required — Spokeo's public directory does not block standard crawlers.