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

person=
{
  "names": [
    {
      "first": "Clark",
      "last": "Kent"
    }
  ],
  "addresses": [
    {
      "city": "Metropolis",
      "state": "IL",
      "country": "US"
    },
    {
      "city": "Wichita",
      "state": "KS",
      "country": "US"
    }
  ],
  "emails": [
    {
      "address": "clark.kent@example.com"
    },
    {
      "address": "ckent@hotmail.com"
    }
  ],
  "phones": [
    {
      "raw": "+1(312) 684-5000"
    },
    {
      "raw": "(312) 352-9327"
    }
  ]
 }

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": "clark.kent@example.com" }, { "address": "ckent@hotmail.com" } ], "phones": [ { "raw": "+1(312) 684-5000" }, { "raw": "(312) 352-9327" } ] }

from piplapis.data import Person, Name, Address, Email, Phone
from piplapis.search import SearchAPIRequest

fields = [
    Name(first=u'Clark', last=u'Kent'),
    Address(city=u'Chicago', state=u'IL', country=u'US'),
    Address(city=u'Wichita', state=u'KS', country=u'US'),
    Email(address=u'clark.kent@example.com'),
    Email(address=u'ckent@hotmail.com'),
    Phone(raw=u'+1(312) 684-5000'),
    Phone(raw=u'(312) 352-9327')
]
request = SearchAPIRequest(person=Person(fields=fields), api_key='YOUR_KEY', show_sources='matching')
response = request.send()

require 'pipl'

person = Pipl::Person.new
person.add_field Pipl::Name.new(first: 'Clark', last: 'Kent')
person.add_field Pipl::Address.new(city: 'Chicago', state: 'IL', country: 'US')
person.add_field Pipl::Address.new(city: 'Wichita', state: 'KS', country: 'US')
person.add_field Pipl::Email.new(address: 'clark.kent@example.com')
person.add_field Pipl::Email.new(address: 'ckent@hotmail.com')
person.add_field Pipl::Phone.new(raw: '+1(312) 684-5000')
person.add_field Pipl::Phone.new(raw: '(312) 352-9327')

response = Pipl::client.search person: person, api_key: 'YOUR_KEY', show_sources: 'matching'

import java.util.ArrayList;
import java.util.List;
import com.pipl.api.search.SearchAPIRequest;
import com.pipl.api.data.containers.Person;
import com.pipl.api.data.fields.*;
import com.pipl.api.search.SearchConfiguration;

SearchConfiguration configuration = new SearchConfiguration();
configuration.setProtocol("https");
configuration.apiKey = "YOUR_KEY";
configuration.showSources = "matching";

List<Field> fields = new ArrayList<Field>();
fields.add(new Name.Builder().first("Clark").last("Kent").build());
fields.add(new Address.Builder().city("Chicago").state("IL").country("US").build());
fields.add(new Address.Builder().city("Wichita").state("KS").country("US").build());
fields.add(new Email.Builder().address("clark.kent@example.com").build());
fields.add(new Email.Builder().address("ckent@hotmail.com").build());
fields.add(new Phone.Builder().raw("+1(312) 684-5000").build());
fields.add(new Phone.Builder().raw("(312) 352-9327").build());

Person person = new Person(fields);
SearchAPIRequest request = new SearchAPIRequest(person, configuration);
SearchAPIResponse response = request.send();

<?php

require_once './piplapis/search.php';

$configuration = new PiplApi_SearchRequestConfiguration();
$configuration->use_https = true;
$configuration->api_key = 'YOUR_KEY';
$configuration->show_sources = 'matching';

$fields = array(
    new PiplApi_Name(array("first" => "Clark", "last" => "Kent")),
    new PiplApi_Address(array("city" => "Chicago", "state" => "IL", "country" => "US")),
    new PiplApi_Address(array("city" => "Wichita", "state" => "KS", "country" => "US")),
    new PiplApi_Email(array("address" => "clark.kent@example.com")),
    new PiplApi_Email(array("address" => "ckent@hotmail.com")),
    new PiplApi_Phone(array("raw" => "+1(312) 684-5000")),
    new PiplApi_Phone(array("raw" => "(312) 352-9327"))
);

$person = new PiplApi_Person($fields);
$request = new PiplApi_SearchAPIRequest(array('person' => $person), $configuration);
$response = $request->send();

?>

using Pipl.APIs.Search;
using System.Collections.Generic;

SearchConfiguration searchConfiguration = new SearchConfiguration(
    apiKey: "YOUR_KEY",
    url: "api.pipl.com/search/",
    useHttps: true
);
searchConfiguration.ShowSources = "matching";

List<Field> fields = new List<Field>()
{
    new Name(first: "Clark", last: "Kent"),
    new Address(city: "Chicago", state: "IL", country: "US"),
    new Address(city: "Wichita", state: "KS", country: "US"),
    new Email(address: "clark.kent@example.com"),
    new Email(address: "ckent@hotmail.com"),
    new Phone(raw: "+1(312) 684-5000"),
    new Phone(raw: "(312) 352-9327")
};

var person = new Person(fields);
SearchAPIRequest request = new SearchAPIRequest(
    person: person,
    requestConfiguration: searchConfiguration
);
var response = await request.SendAsync();

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

from piplapis.search import SearchAPIRequest

# Using username
request = SearchAPIRequest(username=u'clark.kent@linkedin', api_key='YOUR_KEY', show_sources='matching')
response = request.send()

# Using userid
request = SearchAPIRequest(userid=u'1234567@facebook', api_key='YOUR_KEY', show_sources='matching')
response = request.send()

# Using url
request = SearchAPIRequest(url=u'https://linkedin.com/in/ClarkKent', api_key='YOUR_KEY', show_sources='matching')
response = request.send()

require 'pipl'

# Using username
response = Pipl::client.search username: 'clark.kent@linkedin', api_key: 'YOUR_KEY', show_sources: 'matching'

# Using userid
response = Pipl::client.search userid: '1234567@facebook', api_key: 'YOUR_KEY', show_sources: 'matching'

# Using url
response = Pipl::client.search url: 'https://linkedin.com/in/ClarkKent', api_key: 'YOUR_KEY', show_sources: 'matching'

import com.pipl.api.search.SearchAPIRequest;
import com.pipl.api.search.SearchAPIResponse;
import com.pipl.api.search.SearchConfiguration;

SearchConfiguration configuration = new SearchConfiguration();
configuration.setProtocol("https");
configuration.apiKey = "YOUR_KEY";
configuration.showSources = "matching";

// Using username
SearchAPIRequest request = new SearchAPIRequest.Builder()
    .username("clark.kent@linkedin")
    .configuration(configuration)
    .build();
SearchAPIResponse response = request.send();

// Using userid
request = new SearchAPIRequest.Builder()
    .userid("1234567@facebook")
    .configuration(configuration)
    .build();
response = request.send();

// Using url
request = new SearchAPIRequest.Builder()
    .url("https://linkedin.com/in/ClarkKent")
    .configuration(configuration)
    .build();
response = request.send();

<?php

require_once './piplapis/search.php';

$configuration = new PiplApi_SearchRequestConfiguration();
$configuration->use_https = true;
$configuration->api_key = 'YOUR_KEY';
$configuration->show_sources = 'matching';

// Using username
$request = new PiplApi_SearchAPIRequest(
    array('username' => 'clark.kent@linkedin'),
    $configuration
);
$response = $request->send();

// Using userid
$request = new PiplApi_SearchAPIRequest(
    array('userid' => '1234567@facebook'),
    $configuration
);
$response = $request->send();

// Using url
$request = new PiplApi_SearchAPIRequest(
    array('url' => 'https://linkedin.com/in/ClarkKent'),
    $configuration
);
$response = $request->send();

?>

using Pipl.APIs.Search;

SearchConfiguration searchConfiguration = new SearchConfiguration(
    apiKey: "YOUR_KEY",
    url: "api.pipl.com/search/",
    useHttps: true
);
searchConfiguration.ShowSources = "matching";

// Using username
SearchAPIRequest request = new SearchAPIRequest(
    username: "clark.kent@linkedin",
    requestConfiguration: searchConfiguration
);
var response = await request.SendAsync();

// Using userid
request = new SearchAPIRequest(
    userid: "1234567@facebook",
    requestConfiguration: searchConfiguration
);
response = await request.SendAsync();

// Using url
request = new SearchAPIRequest(
    url: "https://linkedin.com/in/ClarkKent",
    requestConfiguration: searchConfiguration
);
response = await request.SendAsync();

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 codeusername/code parameter to search by a vehicle VIN using the format code########@vin/code

vin=JNKBV61EX7M710824

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

from piplapis.search import SearchAPIRequest

# Using vin parameter
request = SearchAPIRequest(vin=u'JNKBV61EX7M710824', api_key='YOUR_KEY', show_sources='matching')
response = request.send()

# Using username with @vin format
request = SearchAPIRequest(username=u'JNKBV61EX7M710824@vin', api_key='YOUR_KEY', show_sources='matching')
response = request.send()

require 'pipl'

# Using vin parameter
response = Pipl::client.search vin: 'JNKBV61EX7M710824', api_key: 'YOUR_KEY', show_sources: 'matching'

# Using username with @vin format
response = Pipl::client.search username: 'JNKBV61EX7M710824@vin', api_key: 'YOUR_KEY', show_sources: 'matching'

import com.pipl.api.search.SearchAPIRequest;
import com.pipl.api.search.SearchAPIResponse;
import com.pipl.api.search.SearchConfiguration;

SearchConfiguration configuration = new SearchConfiguration();
configuration.setProtocol("https");
configuration.apiKey = "YOUR_KEY";
configuration.showSources = "matching";

// Using vin parameter
SearchAPIRequest request = new SearchAPIRequest.Builder()
    .vin("JNKBV61EX7M710824")
    .configuration(configuration)
    .build();
SearchAPIResponse response = request.send();

// Using username with @vin format
request = new SearchAPIRequest.Builder()
    .username("JNKBV61EX7M710824@vin")
    .configuration(configuration)
    .build();
response = request.send();

<?php

require_once './piplapis/search.php';

$configuration = new PiplApi_SearchRequestConfiguration();
$configuration->use_https = true;
$configuration->api_key = 'YOUR_KEY';
$configuration->show_sources = 'matching';

// Using vin parameter
$request = new PiplApi_SearchAPIRequest(
    array('vin' => 'JNKBV61EX7M710824'),
    $configuration
);
$response = $request->send();

// Using username with @vin format
$request = new PiplApi_SearchAPIRequest(
    array('username' => 'JNKBV61EX7M710824@vin'),
    $configuration
);
$response = $request->send();

?>

using Pipl.APIs.Search;

SearchConfiguration searchConfiguration = new SearchConfiguration(
    apiKey: "YOUR_KEY",
    url: "api.pipl.com/search/",
    useHttps: true
);
searchConfiguration.ShowSources = "matching";

// Using vin parameter
SearchAPIRequest request = new SearchAPIRequest(
    vin: "JNKBV61EX7M710824",
    requestConfiguration: searchConfiguration
);
var response = await request.SendAsync();

// Using username with @vin format
request = new SearchAPIRequest(
    username: "JNKBV61EX7M710824@vin",
    requestConfiguration: searchConfiguration
);
response = await request.SendAsync();

CPF (Brazilian Identification number)

The codeusername/code 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

from piplapis.search import SearchAPIRequest

request = SearchAPIRequest(username=u'12345678901@cpf', api_key='YOUR_KEY', show_sources='matching')
response = request.send()

require 'pipl'

response = Pipl::client.search username: '12345678901@cpf', api_key: 'YOUR_KEY', show_sources: 'matching'

import com.pipl.api.search.SearchAPIRequest;
import com.pipl.api.search.SearchAPIResponse;
import com.pipl.api.search.SearchConfiguration;

SearchConfiguration configuration = new SearchConfiguration();
configuration.setProtocol("https");
configuration.apiKey = "YOUR_KEY";
configuration.showSources = "matching";

SearchAPIRequest request = new SearchAPIRequest.Builder()
    .username("12345678901@cpf")
    .configuration(configuration)
    .build();
SearchAPIResponse response = request.send();

<?php

require_once './piplapis/search.php';

$configuration = new PiplApi_SearchRequestConfiguration();
$configuration->use_https = true;
$configuration->api_key = 'YOUR_KEY';
$configuration->show_sources = 'matching';

$request = new PiplApi_SearchAPIRequest(
    array('username' => '12345678901@cpf'),
    $configuration
);
$response = $request->send();

?>

using Pipl.APIs.Search;

SearchConfiguration searchConfiguration = new SearchConfiguration(
    apiKey: "YOUR_KEY",
    url: "api.pipl.com/search/",
    useHttps: true
);
searchConfiguration.ShowSources = "matching";

SearchAPIRequest request = new SearchAPIRequest(
    username: "12345678901@cpf",
    requestConfiguration: searchConfiguration
);
var response = await request.SendAsync();

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

from piplapis.search import SearchAPIRequest

request = SearchAPIRequest(username=u'1234567890@npi', api_key='YOUR_KEY', show_sources='matching')
response = request.send()

require 'pipl'

response = Pipl::client.search username: '1234567890@npi', api_key: 'YOUR_KEY', show_sources: 'matching'

import com.pipl.api.search.SearchAPIRequest;
import com.pipl.api.search.SearchAPIResponse;
import com.pipl.api.search.SearchConfiguration;

SearchConfiguration configuration = new SearchConfiguration();
configuration.setProtocol("https");
configuration.apiKey = "YOUR_KEY";
configuration.showSources = "matching";

SearchAPIRequest request = new SearchAPIRequest.Builder()
    .username("1234567890@npi")
    .configuration(configuration)
    .build();
SearchAPIResponse response = request.send();

<?php

require_once './piplapis/search.php';

$configuration = new PiplApi_SearchRequestConfiguration();
$configuration->use_https = true;
$configuration->api_key = 'YOUR_KEY';
$configuration->show_sources = 'matching';

$request = new PiplApi_SearchAPIRequest(
    array('username' => '1234567890@npi'),
    $configuration
);
$response = $request->send();

?>

using Pipl.APIs.Search;

SearchConfiguration searchConfiguration = new SearchConfiguration(
    apiKey: "YOUR_KEY",
    url: "api.pipl.com/search/",
    useHttps: true
);
searchConfiguration.ShowSources = "matching";

SearchAPIRequest request = new SearchAPIRequest(
    username: "1234567890@npi",
    requestConfiguration: searchConfiguration
);
var response = await request.SendAsync();

Job/Education

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

person=
{
        "names": [{
                        "raw": "Clark Kent"   }],
		"educations": [ {"school": "Metropolis University"} ],
        "jobs": [{"organization": "The Daily Planet"},
                 {"title": "Field Reporter"}]
}

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

from piplapis.data import Person, Name, Education, Job
from piplapis.search import SearchAPIRequest

fields = [
    Name(raw=u'Clark Kent'),
    Education(school=u'Metropolis University'),
    Job(organization=u'The Daily Planet'),
    Job(title=u'Field Reporter')
]
request = SearchAPIRequest(person=Person(fields=fields), api_key='YOUR_KEY', show_sources='matching')
response = request.send()

require 'pipl'

person = Pipl::Person.new
person.add_field Pipl::Name.new(raw: 'Clark Kent')
person.add_field Pipl::Education.new(school: 'Metropolis University')
person.add_field Pipl::Job.new(organization: 'The Daily Planet')
person.add_field Pipl::Job.new(title: 'Field Reporter')

response = Pipl::client.search person: person, api_key: 'YOUR_KEY', show_sources: 'matching'

import java.util.ArrayList;
import java.util.List;
import com.pipl.api.search.SearchAPIRequest;
import com.pipl.api.data.containers.Person;
import com.pipl.api.data.fields.*;
import com.pipl.api.search.SearchConfiguration;

SearchConfiguration configuration = new SearchConfiguration();
configuration.setProtocol("https");
configuration.apiKey = "YOUR_KEY";
configuration.showSources = "matching";

List<Field> fields = new ArrayList<Field>();
fields.add(new Name.Builder().raw("Clark Kent").build());
fields.add(new Education.Builder().school("Metropolis University").build());
fields.add(new Job.Builder().organization("The Daily Planet").build());
fields.add(new Job.Builder().title("Field Reporter").build());

Person person = new Person(fields);
SearchAPIRequest request = new SearchAPIRequest(person, configuration);
SearchAPIResponse response = request.send();

<?php

require_once './piplapis/search.php';

$configuration = new PiplApi_SearchRequestConfiguration();
$configuration->use_https = true;
$configuration->api_key = 'YOUR_KEY';
$configuration->show_sources = 'matching';

$fields = array(
    new PiplApi_Name(array("raw" => "Clark Kent")),
    new PiplApi_Education(array("school" => "Metropolis University")),
    new PiplApi_Job(array("organization" => "The Daily Planet")),
    new PiplApi_Job(array("title" => "Field Reporter"))
);

$person = new PiplApi_Person($fields);
$request = new PiplApi_SearchAPIRequest(array('person' => $person), $configuration);
$response = $request->send();

?>

using Pipl.APIs.Search;
using System.Collections.Generic;

SearchConfiguration searchConfiguration = new SearchConfiguration(
    apiKey: "YOUR_KEY",
    url: "api.pipl.com/search/",
    useHttps: true
);
searchConfiguration.ShowSources = "matching";

List<Field> fields = new List<Field>()
{
    new Name(raw: "Clark Kent"),
    new Education(school: "Metropolis University"),
    new Job(organization: "The Daily Planet"),
    new Job(title: "Field Reporter")
};

var person = new Person(fields);
SearchAPIRequest request = new SearchAPIRequest(
    person: person,
    requestConfiguration: searchConfiguration
);
var response = await request.SendAsync();

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.

person=
{
  "names": [
    {
      "first": "Clark",
      "last": "Kent"
    }
  ],
  "relationships": [
    {
      "names": [
        {
      "first": "Lois",
      "last": "Lane"
        }
      ]
    }
  ]
}

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

from piplapis.data import Person, Name, Relationship
from piplapis.search import SearchAPIRequest

fields = [
    Name(first=u'Clark', last=u'Kent'),
    Relationship(names=[Name(first=u'Lois', last=u'Lane')])
]
request = SearchAPIRequest(person=Person(fields=fields), api_key='YOUR_KEY', show_sources='matching')
response = request.send()

require 'pipl'

person = Pipl::Person.new
person.add_field Pipl::Name.new(first: 'Clark', last: 'Kent')
relationship = Pipl::Relationship.new
relationship.add_field Pipl::Name.new(first: 'Lois', last: 'Lane')
person.add_field relationship

response = Pipl::client.search person: person, api_key: 'YOUR_KEY', show_sources: 'matching'

import java.util.ArrayList;
import java.util.List;
import com.pipl.api.search.SearchAPIRequest;
import com.pipl.api.data.containers.Person;
import com.pipl.api.data.fields.*;
import com.pipl.api.search.SearchConfiguration;

SearchConfiguration configuration = new SearchConfiguration();
configuration.setProtocol("https");
configuration.apiKey = "YOUR_KEY";
configuration.showSources = "matching";

List<Field> fields = new ArrayList<Field>();
fields.add(new Name.Builder().first("Clark").last("Kent").build());

List<Field> relationshipFields = new ArrayList<Field>();
relationshipFields.add(new Name.Builder().first("Lois").last("Lane").build());
fields.add(new Relationship(relationshipFields));

Person person = new Person(fields);
SearchAPIRequest request = new SearchAPIRequest(person, configuration);
SearchAPIResponse response = request.send();

<?php

require_once './piplapis/search.php';

$configuration = new PiplApi_SearchRequestConfiguration();
$configuration->use_https = true;
$configuration->api_key = 'YOUR_KEY';
$configuration->show_sources = 'matching';

$fields = array(
    new PiplApi_Name(array("first" => "Clark", "last" => "Kent")),
    new PiplApi_Relationship(array(
        "names" => array(
            new PiplApi_Name(array("first" => "Lois", "last" => "Lane"))
        )
    ))
);

$person = new PiplApi_Person($fields);
$request = new PiplApi_SearchAPIRequest(array('person' => $person), $configuration);
$response = $request->send();

?>

using Pipl.APIs.Search;
using System.Collections.Generic;

SearchConfiguration searchConfiguration = new SearchConfiguration(
    apiKey: "YOUR_KEY",
    url: "api.pipl.com/search/",
    useHttps: true
);
searchConfiguration.ShowSources = "matching";

List<Field> fields = new List<Field>()
{
    new Name(first: "Clark", last: "Kent"),
    new Relationship(names: new List<Name>() { new Name(first: "Lois", last: "Lane") })
};

var person = new Person(fields);
SearchAPIRequest request = new SearchAPIRequest(
    person: person,
    requestConfiguration: searchConfiguration
);
var response = await request.SendAsync();

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.

person=
{
  "emails": [
	{
  	"address_md5": "b095275aa233df8e857dbca662512ca4"
	}
  ]
}

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

from piplapis.data import Person, Email
from piplapis.search import SearchAPIRequest

fields = [
    Email(address_md5=u'b095275aa233df8e857dbca662512ca4')
]
request = SearchAPIRequest(person=Person(fields=fields), api_key='YOUR_KEY', show_sources='matching')
response = request.send()

require 'pipl'

person = Pipl::Person.new
person.add_field Pipl::Email.new(address_md5: 'b095275aa233df8e857dbca662512ca4')

response = Pipl::client.search person: person, api_key: 'YOUR_KEY', show_sources: 'matching'

import java.util.ArrayList;
import java.util.List;
import com.pipl.api.search.SearchAPIRequest;
import com.pipl.api.data.containers.Person;
import com.pipl.api.data.fields.*;
import com.pipl.api.search.SearchConfiguration;

SearchConfiguration configuration = new SearchConfiguration();
configuration.setProtocol("https");
configuration.apiKey = "YOUR_KEY";
configuration.showSources = "matching";

List<Field> fields = new ArrayList<Field>();
fields.add(new Email.Builder().addressMd5("b095275aa233df8e857dbca662512ca4").build());

Person person = new Person(fields);
SearchAPIRequest request = new SearchAPIRequest(person, configuration);
SearchAPIResponse response = request.send();

<?php

require_once './piplapis/search.php';

$configuration = new PiplApi_SearchRequestConfiguration();
$configuration->use_https = true;
$configuration->api_key = 'YOUR_KEY';
$configuration->show_sources = 'matching';

$fields = array(
    new PiplApi_Email(array("address_md5" => "b095275aa233df8e857dbca662512ca4"))
);

$person = new PiplApi_Person($fields);
$request = new PiplApi_SearchAPIRequest(array('person' => $person), $configuration);
$response = $request->send();

?>

using Pipl.APIs.Search;
using System.Collections.Generic;

SearchConfiguration searchConfiguration = new SearchConfiguration(
    apiKey: "YOUR_KEY",
    url: "api.pipl.com/search/",
    useHttps: true
);
searchConfiguration.ShowSources = "matching";

List<Field> fields = new List<Field>()
{
    new Email(addressMd5: "b095275aa233df8e857dbca662512ca4")
};

var person = new Person(fields);
SearchAPIRequest request = new SearchAPIRequest(
    person: person,
    requestConfiguration: searchConfiguration
);
var response = await request.SendAsync();

Multiple Phones, emails or Addresses​

Social Profiles (Facebook, LinkedIn and others)​

US VIN (Vehicle Identification Number)​

CPF (Brazilian Identification number)​

NPI (US National Provider identifier - medical professionals)​

Job/Education​

Relationship​

Email in MD5 format​