Skip to content

USPhoneBook Scraper

Try for free

Look up people on USPhoneBook by phone number or by name (with city and state): age, current and past addresses, phones with type and carrier, emails, relatives and associates. This data comes from public records. It may not be used for employment, tenant, credit or insurance screening or any other purpose covered by the FCRA.

☎️ USPhoneBook Scraper

Look up people on USPhoneBook by phone number or by name, with an optional city and state, and get one clean row per person: name, age and birth month, current address, past addresses with dates, current and past phone numbers with line type and carrier, emails, other names they used, relatives, associates and the profile link. No login, no proxy to set up.

✨ Why use USPhoneBook Scraper?

  • ☎️ Reverse phone lookup: find out who a US number belongs to, with that person's full profile.
  • 🔎 Name search with city and state: John Smith | Tampa, FL returns the best-matching people first: the exact name before similar ones, and people who live in that city before people who only lived there.
  • 🧾 Full profiles in one row: addresses with move-in and move-out months, every phone with its type and carrier, emails, aliases, relatives and associates.
  • 🎯 Only the person you asked for: results whose name and other names do not match your search are left out and not charged. Each row says whether it matched on the person's name or on another name they used.
  • 🛡️ Handles the site's interstitial checks: pages run in a real browser on US residential IPs. A refused session is dropped and the page is tried again on a new IP. In our tests of 70 name searches and 28 phone lookups, every search was answered.
  • 🔗 Works on other runs' results: point it at a lead list and it looks up the phone or name field of every row.

🎯 Use cases

  • 📇 Contact enrichment: add a current address, phones and emails to a list of names.
  • ☎️ Caller identification: see who is behind a number before you call back.
  • 🏠 Real estate and property research: find the current contact details of owners and past residents.
  • 🧑‍⚖️ Skip tracing and due diligence: address history, relatives and associates for a known person.

🚀 How to use

  1. Add Names (one per line, First Last | City, ST or First Last | ST), Phone numbers (any US format) or Profile URLs. You can mix them.
  2. Set Profiles per search: how many people to return for each name or phone (best matches first).
  3. Click Start and download the results as JSON, CSV, Excel or HTML, or send them on with an integration.

To look up another run's results, set Dataset ID and name the Phone field or the Name field (plus City field and State field if you have them).

📥 Input example

{
    "names": ["John Smith | Tampa, FL"],
    "phoneNumbers": ["(813) 555-0142"],
    "maxResultsPerSearch": 2
}

📤 Output example

A real row from a test run, shortened to two items per list. House numbers, phone digits, email names, relatives' surnames and profile ids are masked here; the actor returns them in full.

{
    "search_type": "name",
    "query": "John Smith | Tampa, FL",
    "found": true,
    "person_id": "UgDO3A…",
    "url": "https://www.usphonebook.com/john-smith/UgDO3…",
    "name": "John Smith",
    "full_name": "John Smith",
    "deceased": false,
    "matched_by": "name",
    "age": 72,
    "born": "1954-05",
    "born_raw": "May 1954",
    "lives_in": "Tampa, FL",
    "current_address": {
        "street": "**** Pinnacle Heights Cir, Apt 201",
        "city": "Tampa",
        "state": "FL",
        "zip": "33624",
        "full": "**** Pinnacle Heights Cir, Apt 201, Tampa, FL 33624",
        "years": "Apr 2019 - Oct 2026",
        "from": "2019-04",
        "to": "2026-10"
    },
    "previous_addresses": [
        {
            "street": "**** W 26th AVE",
            "city": "Lakewood",
            "state": "CO",
            "zip": "80214",
            "full": "**** W 26th AVE, Lakewood, CO 80214",
            "years": "Feb 2024 - Sep 2025",
            "from": "2024-02",
            "to": "2025-09"
        },
        {
            "street": "**** Sheffield Ct",
            "city": "Oldsmar",
            "state": "FL",
            "zip": "34677",
            "full": "**** Sheffield Ct, Oldsmar, FL 34677",
            "years": "May 2016 - Nov 2025",
            "from": "2016-05",
            "to": "2025-11"
        }
    ],
    "primary_phone": "+1813*****37",
    "primary_phone_raw": "(813) ***-**37",
    "phones": [
        {
            "number": "+1813*****37",
            "number_raw": "(813) ***-**37",
            "type": "Landline",
            "carrier": "Frontier Florida Llc Dba Frontier Communications Of Florida",
            "last_reported": null,
            "last_reported_raw": null,
            "current": true
        },
        {
            "number": "+1813*****11",
            "number_raw": "(813) ***-**11",
            "type": "Landline",
            "carrier": "Mci Worldcom Communications Inc - Fl",
            "last_reported": "2025-12",
            "last_reported_raw": "December 2025",
            "current": false
        }
    ],
    "emails": [
        "d*****@hotmail.com",
        "j*****@yahoo.com"
    ],
    "also_known_as": [
        "John D Smith"
    ],
    "relatives": [
        {
            "name": "Jacqueline S****",
            "url": "https://www.usphonebook.com/jacqueline-…"
        },
        {
            "name": "Adele S****",
            "url": "https://www.usphonebook.com/adele-…"
        }
    ],
    "associates": [
        {
            "name": "Thomas H******",
            "url": "https://www.usphonebook.com/thomas-…"
        }
    ],
    "duplicate": false,
    "scraped_at": "2026-11-17T02:09:17.993Z"
}

A search with no match gives one row with found: false and is not charged:

{ "search_type": "name", "query": "Zqxw Vbnmk | FL", "found": false, "error": null, "scraped_at": "2026-11-17T02:13:40.120Z" }
FieldWhat it is
search_type, queryWhich search found the person: name, phone or profile, and the search as read
foundtrue for a person, false for a search with no match (not charged)
matched_byName searches: name when the person's own name matches, alias when another name they used matches (for example a maiden name)
person_id, urlUSPhoneBook profile id and link
name, full_nameName as shown, and the full name with middle name or initial
deceasedtrue when the site marks the person as deceased
age, born, born_rawAge, and birth month as YYYY-MM (as shown on the site in born_raw)
lives_in, current_addressCurrent city and state, and the current street address with ZIP, the months lived there as shown (years) and as from / to in YYYY-MM
previous_addressesEarlier addresses, same shape (the site shows up to 4)
primary_phone, primary_phone_rawCurrent phone in E.164 (+18135550142), and as shown on the site
phonesAll phones with number (E.164), number_raw, type (Wireless, Landline or Voip), carrier, last_reported for past numbers (YYYY-MM, original in last_reported_raw) and current
emailsEmail addresses shown on the profile
also_known_asOther names and spellings the person used
relatives, associatesPeople with name and profile url
duplicatetrue when the same person was already returned by an earlier search in the run (listed again, not charged again)
scraped_atWhen the row was read (ISO 8601, UTC)
errorWhy a search could not be done (bad input, or the site kept refusing it)

⚠️ Good to know

  • This data comes from public records. It may not be used for employment, tenant, credit or insurance screening or any other purpose covered by the FCRA.
  • You pay only for person profiles returned. Searches with no match, results with another person's name, bad input and people already returned earlier in the same run are not charged.
  • US people only, and only what USPhoneBook shows for free. Paid background reports, criminal records and the full relative lists behind the site's "and more" links are not scraped.
  • Records can be out of date or mix up people with the same name. Check age, lives_in and matched_by before you act on a row.
  • The site shows no email for about one profile in twelve, and no phone for about one in fifty (in our test of 148 profiles: emails on 92%, phones on 98%, past addresses on 95%).
  • A reverse phone lookup returns the person USPhoneBook names as the current owner, which may not be who had the number before. In our test of 11 numbers, 10 of those profiles also list the number itself; for the other one the site has linked the number to the person without showing it on the profile.
  • A name search returns people with that name who live or lived in the place you give. For common names, some of them may have moved away: in our test of 160 people returned by city searches, 40% still live in that city and 66% in that state.
  • Each profile takes a few seconds, since every page is opened in a real browser: 30 name searches (82 profiles) took about 10 minutes with the default 2 GB of memory. More memory runs more browsers at once (up to 4).

❓ FAQ

Is it legal? The actor reads pages anyone can open without an account. You are responsible for how you use the data. People-search data is regulated in the US by the FCRA: do not use it for employment, tenant, credit or insurance decisions.

Do I need my own proxy? No. US residential IPs are included.

Why did a name search return someone with a different name? USPhoneBook also lists people who once used that name, for example before marriage. Those rows have matched_by: "alias" and the searched name is in also_known_as.

Can I chain it to an earlier run automatically? Yes. Use an integration or webhook on the earlier run that starts this Actor with datasetId set to the first run's defaultDatasetId and the phone or name field named.

//From the blog\\

Latest articles

All articles

The internet is full of data.
Start owning yours.

Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes.

No credit card. No setup calls.