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": "cl[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"
}
]
}
Updated 10 months ago