Gather people contact information

Introduction

By providing a general lead's name we can search our people database to see if any contact information is available.

Searching against a known target list

If your company provides leads, you likely have access to lists of known individuals' names. These lists will likely contain each person's name, email, and other identifiers. A list may look like:

First Name, Last Name Joe, Curry Tina, Harris Luis, Fiego

You can take information like this and use it to find matching individuals in our people database. Here's how such a search might look:

{
  "query": "firstName:Joe AND lastName:Curry",
  "num_records": 10
}

If a matching record comes back, it will include the company that currently employs the individual. (with more data)

 {
   "country": "US",
   "emails": [
     "joe.curry@universallumpers.com",
     "jcurry@universallumpers.com"
            ],
   "firstName": "joe",
   "gender": "male",
 }

Matching your lead to the targeted area

As you match each person and find their area that they reside, you can enhance your query to hone your record result to the demographic of that specific person.

{
  "query": "firstName:Joe AND lastName:Curry AND country:US AND province:CO AND city:denver",
  "num_records": 10
}

This will guarantee that the person in question is from the US, Denver, Colorado area.

Matching via email

You can also search via the email of the person you are looking for. Utilizing our emails field, you can search via the email.

{
  "query": "emails:"ctrivedi@remax.net"",
  "num_records": 1
}

Example files

Here are example bulk download files of our previous query:

• Denver leads CSV

• Denver leads JSON

Looking up a person via peopleKey from property data

Property data can include a peopleKey that links directly to a matching record in the people database. Depending on the property subfield, you may find this identifier in places such as owners.peopleKey, people.peopleKey, or brokers.people_key. Once you have that value, search the people database by matching it against the keys field.

Step 1: Find the peopleKey in property data

Start by searching property data for Nathan Sandel and require that a peopleKey exists on the owner record.

{
  "query": "owners.firstName:Nathan AND owners.lastName:Sandel AND owners.peopleKey:*",
  "num_records": 1
}

A matching property record may include an owner entry like this:

{
  "owners": [
    {
      "firstName": "Nathan",
      "lastName": "Sandel",
      "peopleKey": "nathan/sandel/us/tx/78704/412southcongressave"
    }
  ]
}

Step 2: Search people data using the peopleKey

Use the peopleKey value from the property result to query the people database through the keys field.

{
  "query": "keys:"nathan/sandel/us/tx/78704/412southcongressave"",
  "num_records": 1
}

A matching people record may look like this:

{
  "firstName": "Nathan",
  "lastName": "Sandel",
  "keys": [
    "nathan/sandel/us/tx/78704/412southcongressave"
  ],
  "phoneNumbers": [
    "+1-512-555-0184"
  ],
  "emails": [
    "nathan.sandel@austinholdings.com"
  ],
  "country": "US",
  "province": "TX",
  "city": "Austin"
}

Field name differences in property data

The field name varies depending on where the identifier appears in property data. owners.peopleKey and people.peopleKey use camelCase, while brokers.people_key uses snake_case. All of these values link to the same keys field in people data.

For a full walkthrough, see Accessing owners, brokers, & other people data.

Conclusion

With the knowledge of how to pull records with business-specific categories, you can now pull targeted area leads for your outreach.