Person Search

Person Search returns a list of people who meet the specified search criteria. The search criteria are based on the input parameters. The HTTP request for Person Search begins with the URL structure:

http://partnerapi.zoominfo.com/partnerapi/person/search?

Input Parameters – Person Search

When you form a Person Search query, you have different input options. Input parameter descriptions are grouped as follows:

  • Group - The grouping for search field permissions.
  • Field Name - The name of the input parameter.
  • Required - Denotes whether or not the field is required in a query.
  • Value - Valid values for the input parameter.
  • Notes - Information related to the input parameter.
  • Key - Denotes whether or not this field is used in key generation. The order in which the parameters appear in the table is the order in which you should use them in the key.


Group
Field Name
Required
Value
Notes
Key
Default
pc
required

Partner code (name) assigned to you
no
outputType
optional
xml or json
Output type of the response. Case insensitive.
no
outputFieldOptions
optional

Person Search has the following optional output fields:
  • localAddress
  • companyAddress
  • companyRevenue
  • companyRevenueNumeric
  • companyRevenueRange
  • companyEmployeeCount
  • companyEmployeeRange
  • companyTopLevelIndustry
  • companyWebsite
  • jobFunction
  • managementLevel
  • companyLogo
  • companyHashtags
  • companyType
  • hasCanadianEmail
  • nameSuffix
  • orderHashtags
  • gender
  • techAttributes
To return one or more of these fields, specify the above output field name(s). To return multiple output fields, separate the values with a comma. Ex: "outputFieldOptions=localAddress,companyAddress" will return localAddress and companyaddress in the output,
no
key
required

String consisting of 5 parameters concatenated together, and then encrypted with MD5. Parameters are:
 1) first 2 characters of every search term
 2) your partner password
 3) today's day (not padded with zero)
 4) today's month (not padded with zero)
 5) today's year (4 digit)
no
excludeBoardMembers
optional
true or false
By default, the API includes board members in person search results. Setting this parameter to true will exclude any board members from person search results.
no
excludeNoCompany
optionaltrue or falseBy default, the API includes people who do not have a company associated with them (AKA “partial profiles”) in person search results.  Setting this parameter to true will exclude partial profiles from person search results.no
Results Per Page
rpp
optional

Limits the results returned to the given number of results per page
no
page
optional

Provides the results for the given page, used in conjunction with rpp
no
Sort
SortBy
optional
See list of values.
Designates by which field you want to sort the results. You must provide SortBy parameters if specifying SortOrder. By default, we sort the results by relevance.
no
SortOrder
optional
asc or desc
Default value is desc. Provide SortBy if specifying SortOrder.
no
Name
firstName
optional

First name of the person being searched for
yes
middleInitial
optional

Middle initial of the person being searched for
yes
lastName
optional

Last name of the person being searched for
yes
Title
personTitle
optional

Title of the person being searched for (ex. VP of sales)
yes
TitleSeniority
optional
See list of values.
Restricts searches to people in one or more of the following: Board Members, Executives, Mid Management, Non Management, C_EXECUTIVES, VP_EXECUTIVES, DIRECTOR, MANAGER. Accepts multiple values by passing a comma-separated list.
yes
TitleClassification
optional
See list of values.
Restricts searches to people with a title related to the title classification specified. Accepts multiple values by passing a comma-separated list.
yes
Company ID
companyId
optional

Searches for people who work or have worked for the specific company which has this unique ZoomInfo company ID.
yes
Company Name
companyName
optional

Searches for people who work or have worked for a specific company.
yes
Industry/
Keyword
companyDesc
optional

Search for people whose companies contain the given description.
yes
IndustryClassification
optional
See list of values.
A hierarchy of industries. See list of industry codes here. Accepts multiple values by passing a comma-separated list. Searches for people within these industries.
yes
IndustryKeywords
optional

Search for people in the industry related to the given search term. Accepts multiple values by passing a comma-separated list.
yes
IndustryCodeoptionalSIC####
NAICS####

(#### is a SIC or NAICS code)
Search for people who work at companies classified as a given search code value. Each code represents an industry area.
CompanyTypeoptionalpublic, private, education, nonprofit, governmentSearch for companies that fall under given company sector category.Accepts multiple values by passing a comma-separated list. It is case-insensitive.
no
Geography
State
optional
See list of values.
Searches for people in one or more US states. Accepts multiple values by passing a comma-separated list (also accepts USA-all or Canada-all). Supports State abbreviations(MA,CA). It is case-insensitive. Blank values are not allowed.

yes
MetroRegion
optional
See list of values.
Searches for people in one or more metro regions (ex. Detroit, MI). Accepts multiple values by passing a comma-separated list.
yes
Country
optional
See list of values
Searches for people in one or more countries. Accepts multiple values by passing a comma-separated lis (Example: USA,Sweden,Brazil) It is case-insensitive. Blank values are not allowed. Both country code or names are accepted(Country.USA or USA). USA-all, Canada-all, uk-all, australia-all are also acceptable.

yes
ZipCode
optional

Restricts search to an area determined by zip code. Use this parameter in combination with RadiusMiles to increase the size of the area to search.

Rules for entering zip code values:
  1. U.S. zip codes are accepted in two formats ##### or ##### - ####
  2. Canadian zip codes are also accepted in format A1A 1A1
  3. Multiple U.S. and Canadian zip codes can be entered in the following three formats
    1. OR separated (i.e. Y1G 1A1 OR 02135 OR A1A 1A1 OR 02314-9984). The OR must be in upper case
    2. Comma-separated (i.e. Y1G 1A1, 02135,A1A 1A1,02314-9984)
    3. Space-separated (i.e. Y1G 1A1 02135A1A 1A102314-9984)
  4. Any zip code or list of zip codes can be preceded by NOT (in uppercase only) to exclude all zip codes specified from the search. Any NOT placed between multiple zip code values will be ignored. Examples:
    • NOT 02315
    • NOT 02314-9984
    • NOT A1A 1A1
    • NOT Y1G 1A1 OR 02135 OR A1A 1A1 OR 02314-9984
    • NOT Y1G 1A1, 02135, A1A 1A1, 02314-9984
    • NOT Y1G 1A1 02135 A1A 1A1 02314-9984
    • Y1G 1A1 NOT 02135 OR A1A 1A1 NOT 02314-9984 will behave the same as Y1G 1A1 OR 02135 OR A1A 1A1 OR 02314-9984
  5. Any invalid zip codes will simply be ignored. Examples:
    • Y1G OR 02135 OR A1A 1A1 OR 02314-984 OR 12 will behave the same as 02135 OR A1A 1A1
    • NOT Y1G OR 02135 NOT A1A 1A1 OR 02314-984 OR 12 will behave the same as NOT 02135 OR A1A 1A1
  6. Parenthesis cannot be used.

yes
RadiusMiles
optional
See list of values.
Used in conjunction with ZipCode, designates how far in miles from zip code to include in search.
yes
location
optional

Accepts any address, city, state, country, or zipcode and searches for people at that location.
yes
locationSearchType
optional
PersonOrHQ,
PersonAndHQ,
Person, or
HQ
Used in conjunction with other Geography group parameters to allow a person search request to find people related to the location they specify in the following ways:
  • PersonOrHQ - Finds people who are either located at the specified location or who's Company HQ is located at the specified location
  • PersonAndHQ - Finds people who are BOTH located at the specified location AND who’s Company HQ is located at the specified location
  • Person - Finds people located at the specified location
  • HQ - Finds people who's Company HQ is located at the specified location
yes
Company Size
RevenueClassificationMin
optional
See list of values.
Minimum revenue dollar amount of a company. Use this parameter with RevenueClassificationMax to set a range. Cannot be used with RevenueClassification.
yes
RevenueClassificationMax
optional
See list of values.
Maximum revenue dollar amount of a company. Use this parameter with RevenueClassificationMin to set a range. Cannot be used with RevenueClassification.
yes
RevenueClassification
optional
See list of values.
Accepts a comma separated list of revenue ranges for a company. Cannot be used with RevenueClassificationMin and/or RevenueClassificationMax.
yes
EmployeeSizeClassificationMin
optional
See list of values.
Minimum employee size of a company. Use this parameter with EmployeeSizeClassificationMax to set a range. Cannot be used with EmployeeSizeClassification
yes
EmployeeSizeClassificationMax
optional
See list of values.
Maximum employee size of a company. Use this parameter with EmployeeSizeClassificationMin to set a range. Cannot be used with EmployeeSizeClassification.
yes
EmployeeSizeClassification
optional
See list of values.
Accepts a comma separated list of employee size ranges for a company. Cannot be used with EmployeeSizeClassificationMin and/or EmployeeSizeClassificationMax.
yes
CompanyRanking
optional
See list of values.
Restricts searches to a company in a specific ranked list Ex. Fortune 500. Accepts multiple values by passing a comma-separated list.
yes
Education
school
optional

Searches for people who attended a specific school or university.
yes
degree
optional

Searches for people who have received a specific type of degree (ex. bachelors, masters, etc).
yes
Diversity
gender
optional
"Female" ,"Male"
Searches for people based on their gender.
yes
Source Website
companyDomainName 
optional

Searches for people who work at the company with this domain name.
yes
personWebReferencesoptional

Restricts searches to people who are found on a specific websiteno
Credentials
titleCertification
optional

Searches for people who hold a certain credential or certification (ex. Registered Nurse). This input parameter searches both current and past titles for the specified credential or certification.
yes
Date Filters
companyPastOrPresent
optional
See list of values.
Designates the type of company the search criteria should be applied to: the person's present and past company, present company only, or past company only.

Note: This parameter will only affect search results if one or more of the following input parameters are used:
  • personTitle
  • titleCertification
  • titleClassification
  • companyName
  • CompanyDomainName
  • industryClassification
  • industryKeywords
yes
ValidDateMonthDist
optional
Time period in months
Searches for people whose profile has been updated within a certain time period.
yes
Contact Filter
ContactRequirements
optional
See list of values.
Searches for people who have a certain type of contact information.
yes
Email
EmailAddress
optional

Searches for people based on email address.
yes
techAttributestechAttributeTagoptional
Searches for people based on techAttribute tag. Accepts wild card characters, but not a leading wild card. Accepts multiple values by passing a comma-separated list. Examples: enterprise_applications.commerce.zen_cart.zen_cart,it_governance.change_management.ibm.ibm_rational_doors
enterprise_applications.commerce.*,it_governance.change_management.ibm.*
no


Example Person Search Query

The following example shows a Person Search query. The input parameters include:

  • President for personTitle
  • 33624074 for IndustryClassification (Television Stations)
  • New%20York for State

Note: We used %20 to denote where a space occurs in the state name for the example .

The Person Search query request should be structured as follows:

http://partnerapi.zoominfo.com/partnerapi/person/search?pc=PartnerCode&personTitle=President&IndustryClassification=33624074&State=New%20York&key=EncryptedKey

If the query was run on August 31, 2014, then the key would include the following combination of numbers and letters:

      Pr33NePassword3182014

After MD5 encryption, the key would be:

      a6768d549489bd734fa978c9f022e00c

With this key, the query request would be composed as follows:

http://partnerapi.zoominfo.com/partnerapi/person/search?pc=PartnerCode&personTitle=President&IndustryClassification=33624074&State=New%20York&key=a6768d549489bd734fa978c9f022e00c

The resulting Person Search output would appear in XML as follows:

<PeopleSearchRequest
 xmlns="http://partnerapi.zoominfo.com/partnerapistatic/xsd/V1/
PeopleQuery.xsd">
 <SearchParameters>
 <Parameter>
<Name>persontitle</Name>
 <Value>President</Value>
 </Parameter>
 <Parameter>
 <Name>industryclassification</Name>
 <Value>33624074</Value>
</Parameter>
 <Parameter>
 <Name>state</Name>
 <Value>New York</Value>
 </Parameter>
 </SearchParameters>
 <TotalResults>1037</TotalResults>
<MaxResults>12378</MaxResults>
 <PeopleSearchResults>
 <PersonRecord>
 <PersonID>17868088</PersonID>
 <ZoomPersonUrl> http://www.zoominfo.com/#!search/profile/person?personId=17868088&
 targetid=profile </ZoomPersonUrl>
 <PersonDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/person/detail?query_type=
 person_detail&PersonID=17868088&pc=PartnerCode&key=EncryptedKey </PersonDetailXmlUrl>
 <LastMentioned>7/3/2014</LastMentioned>
 <IsUserPosted>False</IsUserPosted>
 <IsPast>False</IsPast>
 <ReferencesCount>78</ReferencesCount>
 <FirstName>Warner</FirstName>
 <LastName>Saunders</LastName>
 <Fax>(212) 664-4426</Fax>
 <CurrentEmployment>
<JobTitle>Chief Newscaster</JobTitle>
 <Company>
 <CompanyID>26968099</CompanyID>
 <ZoomCompanyUrl> http://www.zoominfo.com/#!search/profile/company?companyId=26968099&
 targetid=profile </ZoomCompanyUrl>
 <CompanyDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/company/detail?query_type=company_
 detail&CompanyID=26968099&pc=PartnerCode&key=EncryptedKey </CompanyDetailXmlUrl>
 <CompanyName>NBC</CompanyName>
 <CompanyPhone>(212)
 664-4444</CompanyPhone>
 </Company></CurrentEmployment>
 <Industry>Television Stations</Industry>
 </PersonRecord>
 <PersonRecord>
 <PersonID>2127155</PersonID>
 <ZoomPersonUrl> http://www.zoominfo.com/#!search/profile/person?personId=2127155&
 targetid=profile </ZoomPersonUrl>
 <PersonDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/person/detail?query_type=
 person_detail&PersonID=2127155&pc=PartnerCode&key=EncryptedKey </PersonDetailXmlUrl>
 <LastMentioned>7/3/2014</LastMentioned>
 <IsUserPosted>False</IsUserPosted>
 <IsPast>False</IsPast>
<ReferencesCount>583</ReferencesCount>
 <ImageUrl> http://wif.org/images/repository/about/board-of-directors/
 susanne_daniels_udpate_web.jpg </ImageUrl>
 <FirstName>Susanne</FirstName>
 <LastName>Daniels</LastName>
 <Fax>(212) 354-9001</Fax>
 <CurrentEmployment>
 <JobTitle>President of Programming</JobTitle>
 <Company>
 <CompanyID>25838309</CompanyID>
 <ZoomCompanyUrl> http://www.zoominfo.com/#!search/profile/company?companyId=25838309&
 targetid=profile </ZoomCompanyUrl>
 <CompanyDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/company/detail?query_type=
 company_detail&CompanyID=25838309&pc=PartnerCode&key=EncryptedKey </CompanyDetailXmlUrl>
 <CompanyName>MTV</CompanyName>
 <CompanyPhone>(212)
 654-9000</CompanyPhone>
 </Company>
 </CurrentEmployment>
 <Industry>Television Stations</Industry>
 </PersonRecord>
 .... </PeopleSearchResults>
</PeopleSearchRequest>

Output Parameters – Person Search

Person Search returns a list of people in ZoomInfo's data who meet the search criteria. Output parameter descriptions are grouped as follows:

  • Group - The grouping for output field permissions. Permission groups determine the output fields present in a response for a partner.
  • Parent Name - Name of the output element
  • Child Name - Name of a child element of a parent element specified in the parent name column
  • Notes - Information related to the output field
Group
Parent Name
Child Name
Notes
Default
PersonID

Unique identifier for the person
ZoomPersonURL

URL for the person's zoominfo.com public profile
PersonDetailXmlUrl

API request URL for Person Detail. Returned output will be in XML format
LastMentioned

Date the person's profile was last updated
IsUserPosted

Designates if the profile was manually created by the person
IsPast

Designates if the most recent job title we have for a person is a past position
ReferencesCount

Number of web references the person has
ImageUrl

The URL for the person's profile image
FirstName

First name of the person
MiddleInitial

Middle initial of the person
LastName

Last name of the person
LocalAddress

The address of the person's local office
Optional: This output field won't be shown unless the 'outputFieldOptions' parameter contains this output field
Street
Street for the local address.
City
City for the local address
State
State or province for the local address
Zip
Postal code for the local address
CountryCode
Country of the local address
CurrentEmployment

Where the person is currently employed. CurrentEmployment contains child elements. NOTE: If the person has no current employment, then the CurrentEmployment element will not be present.

JobTitle
Person's title at their current place of employment
JobFunction
Person's job function at their current place of employment.
Optional: This output field won't be shown unless the 'outputFieldOptions' parameter contains this output field
ManagementLevel
Person's management level at their current place of employment
Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains this output field
Company

Contains child elements with information about the person's current company
CompanyID
Unique identifier used by ZoomInfo for company
ZoomCompanyUrl
URL for the company's zoominfo.com public profile
CompanyDetailXmlUrl
API request URL for Company Detail. Returned output will be in XML format
CompanyName
Name of the company
CompanyPhone
Phone number of the company headquarters.
CompanyAddress

Address of the person's current company headquarters
Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains this
Street
Street for company
City
City for company
State
State or Province of the company
Zip
Postal Code
Country
Country of the Company
CompanyWebsite
The web domain for the company in http://www.example.com format
CompanyLogo
The URL which can be used to retrieve the logo for the company.
CompanyRevenue
Annual gross revenue for the company. Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains this output field
CompanyRevenueIn000s
Numeric annual gross revenue for the company in 1000's. Optional:This output field won't be shown unless the 'ouputFieldOptions' parameter contains "companyRevenueNumeric"
CompanyRevenueRange
Revenue range for the company. Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains “companyRevenueRange”
CompanyEmployeeCount
Employee head count for the company. Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains this output field
CompanyEmployeeCountRange
Employee head count range for the company. Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains “companyEmployeeRange”
Industries  
TopLevelIndustry

Top Level (and therefore least specific) Industry that the person works in. A person can have multiple top level industries.  Top level industry tags are based on the current employment company. Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains “companyTopLevelIndustry”
Industry

Industry the person currently works in. A person can have multiple industries. Industry tags are based on the current employment company.
Contact Info
Email
You will see ###### if the permission to this output field is not granted
Person's email address in example@example.com format
Phone
You will see ###### if the permission to this output field is not granted
The person's direct phone number, if available.
Fax
You will see ###### if the permission to this output field is not granted
The fax number for the person's current company



Was this article helpful?

Can’t find what you’re looking for?

Contact our award-winning customer care team.