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 .

username=clark.kent@twitter

OR

userid=1234567@facebook

OR

url = https://linkedIn.com/in/ClarkKent
https://api.pipl.com/search/?key=YOUR_KEY&show_sources=matching&username=clark.kent@linkedin

US VIN (Vehicle Identification Number)

You can use 'vin' query parameter to run a search using a vehicle's VIN.

You can also use the username parameter to search by a vehicle VIN using the format ########@vin

vin=JNKBV61EX7M710824 //new!

username=JNKBV61EX7M710824@vin
https://api.pipl.com/search/?key=YOUR_KEY&show_sources=matching&vin=JNKBV61EX7M710824

https://api.pipl.com/search/?key=YOUR_KEY&show_sources=matching&username=JNKBV61EX7M710824@vin

CPF (Brazilian Identification number)

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

username=12345678901@cpf
https://api.pipl.com/search/?key=YOUR_KEY&show_sources=matching&username=12345678901@cpf

NPI (US National Provider identifier - medical professionals)

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

username=1234567890@npi
https://api.pipl.com/search/?key=YOUR_KEY&show_sources=matching&username=1234567890@npi

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"
	}
  ]
}