Advanced Search Queries

Below are some examples for running some more advanced queries

Multiple Phones, emails or Addresses

Using multiple instances of a particular data field in a search query requires using a full person search

https://api.pipl.com/search/?key=YOUR_KEY&show_sources=matching&person={ "names": [ { "first": "Clark", "last": "Kent" } ], "addresses": [ { "city": "Chicago", "state": "IL", "country": "US" }, { "city": "Wichita", "state": "KS", "country": "US" } ], "emails": [ { "address": "[email protected]" }, { "address": "[email protected]" } ], "phones": [ { "raw": "+1(312) 684-5000" }, { "raw": "(312) 352-9327" } ] }
person=
{
  "names": [
    {
      "first": "Clark",
      "last": "Kent"
    }
  ],
  "addresses": [
    {
      "city": "Metropolis",
      "state": "IL",
      "country": "US"
    },
    {
      "city": "Wichita",
      "state": "KS",
      "country": "US"
    }
  ],
  "emails": [
    {
      "address": "[email protected]"
    },
    {
      "address": "[email protected]"
    }
  ],
  "phones": [
    {
      "raw": "+1(312) 684-5000"
    },
    {
      "raw": "(312) 352-9327"
    }
  ]
 }

Social Profiles (Facebook, LinkedIn and others)

You can search Pipl by social services by the username, userID or even a profile URL. For the complete list of supported services, such as GitHub, Tiktok and others, please see the list of supported services .

[email protected]

OR

[email protected]

OR

url = https://linkedIn.com/in/ClarkKent
https://api.pipl.com/search/?key=YOUR_KEY&show_sources=matching&[email protected]

US VIN (Vehicle Identification Number)

The username parameter is used to search by a vehicle VIN using the format ########@vin

[email protected]
https://api.pipl.com/search/?key=YOUR_KEY&show_sources=matching&[email protected]

CPF (Brazilian Identification number)

The username parameter is used to search by a CPF using the following format "###########@cpf"

[email protected]
https://api.pipl.com/search/?key=YOUR_KEY&show_sources=matching&[email protected]

NPI (US National Provider identifier - medical professionals)

The username parameter is used to search by an NPI using the following format "##########@npi"

[email protected]
https://api.pipl.com/search/?key=YOUR_KEY&show_sources=matching&[email protected]

Job/Education

Searching by job or education in a search query requires using a full person search

https://api.pipl.com/search/?key=YOUR_KEY&show_sources=matching&person={ "names": [{ "raw": "Clark Kent"   }], "educations": [ {"school": "University of Chicago"} ], "jobs": [{"organization": "The Wallstreet Journal"}, {"title": "Field Reporter"}] }
person=
{
        "names": [{
                        "raw": "Clark Kent"   }],
        "educations": [ {"school": "Metropolis University"} ],
        "jobs": [{"organization": "The Daily Planet"},
                 {"title": "Field Reporter"}]
}

Relationship

You can search for a person that has a connection to another. Note that in the relationship object only the name part will be used in the search.

https://api.pipl.com/search/?key=YOUR_KEY&show_sources=matching&person= { "names": [ { "first": "Clark", "last": "Kent" } ], "relationships": [ { "names": [ { "first": "Sam", "last": "Smith" } ] } ] }
person=
{
  "names": [
    {
      "first": "Clark",
      "last": "Kent"
    }
  ],
  "relationships": [
    {
      "names": [
        {
          "first": "Lois",
          "last": "Lane"
        }
      ]
    }
  ]
}

Email in MD5 format

You can search for an MD5 as follows. Please be sure to normalize your email address following the MD5 Calculation guidelines before applying the MD5 hash.

https://api.pipl.com/search/?key=YOUR_KEY&show_sources=matching&person= { "emails": [ { "address_md5": "b095275aa233df8e857dbca662512ca4" } ] }
person=
{
  "emails": [
    {
    "address_md5": "b095275aa233df8e857dbca662512ca4"
    }
  ]
}