🔍 Radaris People Scraper — SkipTrace & People Lookup

Find anyone in the US by name. Extract structured public records — addresses, phone numbers, relatives, employment, education, and aliases — directly from Radaris.com using clean JSON-LD parsing. No browser required. No login. No cookies.

---

What This Actor Does

This actor performs name-based people lookups against radaris.com — one of the largest US public records aggregators. It returns rich, structured profiles ready for your CRM, spreadsheet, or automation pipeline.

Input a first name, last name, and optional US state — get back clean, structured records in seconds.

---

Why This Actor vs. The Competition

Most Radaris scrapers on Apify extract only name and address. This actor goes further.

Feature	This Actor	crawlerbros/radaris-people-search
Phone numbers	✅ Extracted	❌ Not available
Job title	✅ Extracted	❌ Not available
Current employer	✅ Extracted	❌ Not available
Education / Alumni	✅ Extracted	❌ Not available
Aliases / alternate names	✅ Extracted	✅
Relatives	✅ Extracted	✅
Addresses	✅ Full street + city + state + zip	✅ Partial
Profile ID	✅ Numeric Radaris ID	❌ Name-based only
State filter	✅ ?ql=STATE	✅
Proxy support	✅ Full Apify proxy config (incl. US Residential)	⚠️ Basic
Out-of-funds protection	✅ 402/407 detection + graceful exit	❌
Split first/last name	✅ Auto-parsed from full name	✅
Graceful failure handling	✅ Logs + exits cleanly per error type	⚠️ Basic

Bottom line: if you need more than just a name and a city, this is the actor to use.

---

Output Fields

Each scraped profile is a clean JSON object:

{
  "id": "123456789",
  "fullName": "Michael Anderson",
  "firstName": "Michael",
  "lastName": "Anderson",
  "birthDate": "1978",
  "jobTitle": "Software Engineer",
  "workCompany": "Acme Corp",
  "education": "Indiana University",
  "phones": ["+13175550192"],
  "addresses": [
    "1234 Maple St, Indianapolis, IN, 46201"
  ],
  "relatives": [
    "Sandra K Anderson",
    "James T Anderson"
  ],
  "aliases": [
    "Mike Anderson",
    "M Anderson"
  ]
}

Field	Type	Description
id	string	Numeric Radaris profile ID extracted from URL
fullName	string	Full name as listed on Radaris
firstName	string	Given name
lastName	string	Family name
birthDate	string	Birth year or date (if public)
jobTitle	string	Current or last known job title
workCompany	string	Employer name
education	string	Educational institution
phones	string[]	Known phone numbers
addresses	string[]	Known residential addresses
relatives	string[]	Family members and known associates
aliases	string[]	Alternate name spellings

---

Input

{
  "firstName": "Michael",
  "lastName": "Anderson",
  "state": "IN",
  "maxItems": 3,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

Field	Type	Required	Default	Description
firstName	string	✅	—	First name of the person to search
lastName	string	✅	—	Last name of the person to search
state	string	❌	—	US state code to narrow results (CA, TX, IN, etc.)
maxItems	integer	❌	3	Max number of profiles to scrape and return
proxyConfiguration	object	❌	—	Apify proxy config (US Residential strongly recommended)

Note: Using Apify US Residential Proxies (RESIDENTIAL group, country US) is strongly recommended to avoid 403 blocks from Radaris. Datacenter IPs may be throttled.

---

How It Works

1. Builds the Radaris search URL from the input first and last name, optionally appending a ?ql=STATE filter.
2. Fetches the page with a Chrome-impersonated TLS fingerprint via curl_cffi — no browser, no Playwright overhead.
3. Parses all <script type="application/ld+json"> blocks on the search results page to find encoded profile links (data-elink).
4. Decodes the Base64-encoded profile URLs and visits each one individually.
5. Extracts the Person JSON-LD entity from each profile page — this is the richest structured data Radaris provides.
6. Cleans and normalizes every field: splits names, parses addresses, deduplicates phones, extracts employer and education.
7. Pushes results to the Apify default dataset.

---

Error Handling

The actor handles all error modes gracefully and logs everything.

Scenario	Behavior
Missing firstName or lastName	Fails immediately with a clear message
Radaris returns 403	Logs a warning, skips, continues
Proxy auth failure (407)	Logs a critical error, stops the run with exit code 2
Payment required (402)	Logs a critical error, stops the run with exit code 2
Profile page has no JSON-LD	Skips silently, continues to next profile
Any unexpected exception	Fails with exit code 3 and a descriptive message

---

Use Cases

• Real estate skip tracing — find landlord contact info, property owner phones and addresses
• Lead enrichment — append employment and contact data to your prospect lists
• Genealogy & research — identify relatives and known associates
• CRM hygiene — verify and update outdated contact records
• Background checks — aggregate public record data for due diligence

---

Proxy Recommendation

Radaris actively limits access from datacenter IPs. For reliable results:

"proxyConfiguration": {
  "useApifyProxy": true,
  "apifyProxyGroups": ["RESIDENTIAL"],
  "apifyProxyCountry": "US"
}

Using non-US or datacenter proxies will likely result in 403 Forbidden responses and empty results.

---

Legal Notice

This actor scrapes publicly available data from Radaris.com in compliance with its public-facing interface. All extracted information is already indexed and accessible without login. Users are responsible for ensuring their use of this data complies with applicable laws, including the FCRA (Fair Credit Reporting Act) and any relevant state privacy regulations. Do not use this actor for FCRA-regulated purposes (credit, employment, housing decisions).

---

FAQ

Do I need cookies or a login? No. The actor performs plain HTTP GET requests against public Radaris profile pages.

Why do I get 403 errors? Radaris blocks some datacenter IPs. Switch to US Residential proxies.

Can I look up someone by phone number? Not with this actor — Radaris only supports name-based search. For reverse phone lookup, see other actors in the store.

Can I scrape more than 3 results? Yes — set maxItems to any number. Be mindful of proxy usage costs for large batches.

Why does the actor sometimes find fewer results than expected? Radaris aggregates profiles per name. Narrow your search with a state filter to improve precision on common names.

What does the numeric id field represent? It's the stable numeric identifier in the Radaris profile URL (e.g., https://radaris.com/p/John/Smith/123456789). It can be used to reconstruct the canonical profile URL.