Sorry, we didn't find any relevant articles for you.
Please fill out the contact form below and we will reply as soon as possible.
optionalPerson Search returns a list of people who meet the specified search criteria. The search criteria are based on the input parameters. The HTTPS request for Person Search begins with the URL structure:
https://partnerapi.zoominfo.com/partnerapi/v4/person/search?
When you form a Person Search query, you have different input options. Input parameter descriptions are grouped as follows:
Group |
Field Name |
Required |
Value |
Notes |
Default |
pc |
required |
Partner code (name) assigned to you |
|
outputType |
optional |
xml or json |
Output type of the response. Case insensitive. |
|
outputFieldOptions |
optional |
Person Search has the following optional output fields:
|
||
key |
required |
OAuth access token returned from the OAuth token request: https://partnerapi.zoominfo.com/partnerapi/v2/token |
||
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. |
|
excludeNoCompany |
optional | true or false | By 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. | |
Results Per Page |
rpp |
optional |
Limits the results returned to the given number of results per page |
|
page |
optional |
Provides the results for the given page, used in conjunction with rpp |
||
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. |
SortOrder |
optional |
asc or desc |
Default value is desc. Provide SortBy if specifying SortOrder. |
|
Name |
fullName |
optional | Full name of the person being searched for | |
firstName |
optional |
First name of the person being searched for |
||
middleInitial |
optional |
Middle initial of the person being searched for |
||
lastName |
optional |
Last name of the person being searched for |
||
Title |
personTitle |
optional |
Title of the person being searched for (ex. VP of sales) |
|
excludedPersonTitle |
optional | Title of the person to exclude (ex. VP of sales). Accepts multiple values by passing a comma-separated list. | ||
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. |
|
excludeTitleSeniority |
optional |
See list of values. |
Exclude 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. |
|
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. |
|
excludeTitleClassification |
optional |
See list of values. |
Exclude people with a title related to the title classification specified. Accepts multiple values by passing a comma-separated list. |
|
returnOnlyBoardMembers |
optional | true or false | By default, the API includes board members in person search results. Setting this parameter to true will only return board members from person search results. |
|
executivesOnly |
optional | true or false | Return only executives. This input is only allowed if a company ID is also being passed. | |
maxNumExecutives |
optional | May only be used in conjunction with executivesOnly input. Using this parameter will limit the number of executives that are returned. | ||
Company ID or Company Domain |
companyId |
optional |
Searches for people who work or have worked for the specific company which has this unique ZoomInfo company ID. |
|
companyIds |
optional | The person’s company's ZoomInfo ID. Accepts multiple values by passing a comma-separated list. |
||
Company Name |
companyName |
optional |
Searches for people who work or have worked for a specific company. |
|
Company Attribute |
hashtagField |
optional | Searches for person based on company attributes. For example, #100_plus_general_management will only return companies that has 100 or more employees in a general management role. Accepts multiple values by passing a comma-separated list. |
|
pubPrivateSectors |
optional | PUBLIC, PRIVATE, EDUCATION, NOT_FOR_PROFIT, NONPROFIT, GOVERNMENT | Search for person whose company is of one or more type in Upper Case. For Example: "NOT_FOR_PROFIT". Accepts multiple values by passing a comma-separated list. |
|
isPublic |
optional | true or false | Search for person whose company that is either public or not. |
|
Industry/ Keyword |
companyDesc |
optional |
Search for people whose companies contain the given description. |
|
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. |
|
IndustryKeywords |
optional |
Search for people in the industry related to the given search term. Accepts multiple values by passing a comma-separated list. |
||
IndustryCode | optional | SIC#### 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. | |
IndustryCodeAnd |
optional | SIC#### NAICS#### (#### is a SIC or NAICS code) |
Similar to industryCode, differently only person whose company have all the listed industryCodes will be returned. |
|
primaryIndustriesOnly |
optional | true or false |
When this parameter is set to "true", any person returned must have one of the specified industries as the top one or two industries. If no industries are specified, then the "primaryIndustriesOnly" input parameter will be ignored. Default is false. |
|
CompanyType | optional | public, private, education, nonprofit, government | Search for companies that fall under given company sector category.Accepts multiple values by passing a comma-separated list. It is case-insensitive. |
|
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. |
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. |
|
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. |
|
Continent |
optional | North America, Europe, Africa, Asia, South America, Oceania |
Searches for people in one or more continents (ex. Asia). Accepts multiple values by passing a comma-separated list. |
|
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:
|
||
RadiusMiles |
optional |
See list of values. |
Used in conjunction with ZipCode, designates how far in miles from zip code to include in search. |
|
isEU | optional | include | exclude | only |
“include” returns all persons; “exclude” returns persons with is_eu = false or is_eu is not specified; “only” returns persons with is_eu = true |
|
location |
optional |
Accepts any address, city, state, country, or zipcode and searches for people at that location. |
||
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:
|
|
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. |
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. |
|
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. |
|
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 |
|
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. |
|
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. |
|
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. |
|
Education |
school |
optional |
Searches for people who attended a specific school or university. |
|
degree |
optional |
Searches for people who have received a specific type of degree (ex. bachelors, masters, etc). |
||
Diversity |
gender |
optional |
"Female", "Male" |
Searches for people based on their gender. |
Source Website |
companyDomainName |
optional |
Searches for people who work at the company with this domain name. |
|
companyDomainNames |
optional | Searches for people who work at the company with this domain name. Accepts multiple values by passing a comma-separated list. | ||
personWebReferences | optional |
Restricts searches to people who has been mentioned on a website containing the specified text. |
||
personWebReferencesURL |
optional | Restricts searches to people who are found on a specific website. | ||
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. |
|
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:
|
ValidDateMonthDist |
optional |
Time period in months |
Searches for people whose profile has been updated within a certain time period. |
|
Contact Filter |
ContactRequirements |
optional |
See list of values. |
Searches for people who have a certain type of contact information. |
PersonID or Email Address |
personIds |
optional | A comma separated list of unique ZoomInfo identifiers of the person to be matched by a particular input record | |
EmailAddress |
optional |
Searches for people based on email address. |
||
hasCanadianEmail |
optional | Include, Exclude, Only | Either include, exclude, or solely return people who have Canadian email addresses | |
techAttributes | techAttributeTag | optional |
Searches for people based on techAttribute tag (aka technology product Ids) . Exact tags represent techAttribute products and wild carded values represent multiple products. Accepts multiple values by passing a comma-separated list. Values can be entered in any of the following formats:
6356 332.7.11831.*, 332.7.*,6356 *.11831.*, 6356 |
|
techAttributesToOutput |
optional | Values can be entered in the same format as techAttributeTag. This input is used to specify which technologies are returned from techAttributes. Be sure to use in conjunction with techAttributes in outputFieldOptions. | ||
techAttributeTagAnd |
optional | Similar to techAttributeTag, different only in that people which have all the listed techAttributes will be returned. |
||
Funding |
fundingStartDate |
optional |
Start Date of the funding, accepts date in this format: YYYY-MM-DD (no time can be specified and Eastern timezone is assumed) |
|
fundingEndDate |
optional |
End Date of the funding, accepts date in this format: YYYY-MM-DD (no time can be specified and Eastern timezone is assumed)
|
||
fundingDaysInPast |
optional |
This parameter is for people who want to find companies with funding in the past N days. This parameter would NOT be allowed to be used with either of the two date parameters. |
||
fundingMinIn000s |
optional |
If fundingMinIn000s alone is entered, the range will be this value in 1000s or greater. It accepts numbers in 1000s (i.e. 1 = 1000, 256 = 256,000) |
||
fundingMaxIn000s |
optional |
If fundingMaxIn000s alone is entered, the range will be this value in 1000s or less. It accepts numbers in 1000s (i.e. 1 = 1000, 256 = 256,000)
|
The following example shows a Person Search query. The input parameters include:
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:
The resulting Person Search output would appear in XML as follows:
<?xml version="1.0" encoding="UTF-8"?>
<personSearchResponse xmlns="http://partnerapi.zoominfo.com/partnerapistatic/xsd/V4">
<searchParameters>
<parameter>
<name>persontitle</name>
<value>President</value>
</parameter>
<parameter>
<name>rpp</name>
<value>4</value>
</parameter>
<parameter>
<name>industryclassification</name>
<value>33624074</value>
</parameter>
<parameter>
<name>state</name>
<value>New York</value>
</parameter>
</searchParameters>
<totalResults>1380</totalResults>
<maxResults>1380</maxResults>
<peopleSearchResults>
<personRecord>
<personId>1274239922</personId>
<zoomPersonUrl>http://www.zoominfo.com/s/#!search/profile/person?personId=1274239922&targetid=profile</zoomPersonUrl>
<personDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/person/detail?PersonID=1274239922&pc=ZoomTestQA&key=4653d9b6-ace3-44b9-ad3c-f90606597817</personDetailXmlUrl>
<firstName>Charles</firstName>
<middleInitial>F.</middleInitial>
<lastName>Stewart</lastName>
<lastUpdatedDate>2018-05-06</lastUpdatedDate>
<isUserPosted>False</isUserPosted>
<industry>Telecommunications</industry>
<industry>Cable & Satellite</industry>
<industry>Telephony & Wireless</industry>
<industry>Television Stations</industry>
<industry>Broadcasting</industry>
<industry>Media & Internet</industry>
<emailAddress>######</emailAddress>
<directPhone>######</directPhone>
<isPast>False</isPast>
<referencesCount>77</referencesCount>
<currentEmployment>
<jobTitle>Co-President and Chief Financial Officer</jobTitle>
<company>
<companyId>356822441</companyId>
<zoomCompanyUrl>http://www.zoominfo.com/s/#!search/profile/company?companyId=356822441&targetid=profile</zoomCompanyUrl>
<companyDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?CompanyID=356822441&pc=ZoomTestQA&key=4653d9b6-ace3-44b9-ad3c-f90606597817</companyDetailXmlUrl>
<companyName>Altice USA</companyName>
</company>
</currentEmployment>
</personRecord>
<personRecord>
<personId>1981501294</personId>
<zoomPersonUrl>http://www.zoominfo.com/s/#!search/profile/person?personId=1981501294&targetid=profile</zoomPersonUrl>
<personDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/person/detail?PersonID=1981501294&pc=ZoomTestQA&key=4653d9b6-ace3-44b9-ad3c-f90606597817</personDetailXmlUrl>
<firstName>John</firstName>
<lastName>Borthwick</lastName>
<lastUpdatedDate>2018-05-04</lastUpdatedDate>
<isUserPosted>False</isUserPosted>
<industry>Television Stations</industry>
<industry>Broadcasting</industry>
<industry>Media & Internet</industry>
<isPast>False</isPast>
<referencesCount>6</referencesCount>
<currentEmployment>
<jobTitle>Chief Executive Officer and President, Betaworks</jobTitle>
<company>
<companyId>42483953</companyId>
<zoomCompanyUrl>http://www.zoominfo.com/s/#!search/profile/company?companyId=42483953&targetid=profile</zoomCompanyUrl>
<companyDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?CompanyID=42483953&pc=ZoomTestQA&key=4653d9b6-ace3-44b9-ad3c-f90606597817</companyDetailXmlUrl>
<companyName>WNYC</companyName>
<companyPhone>(646) 829-4400</companyPhone>
</company>
</currentEmployment>
</personRecord>
<personRecord>
<personId>1976383</personId>
<zoomPersonUrl>http://www.zoominfo.com/s/#!search/profile/person?personId=1976383&targetid=profile</zoomPersonUrl>
<personDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/person/detail?PersonID=1976383&pc=ZoomTestQA&key=4653d9b6-ace3-44b9-ad3c-f90606597817</personDetailXmlUrl>
<firstName>Laura</firstName>
<middleInitial>R.</middleInitial>
<lastName>Walker</lastName>
<lastUpdatedDate>2018-05-04</lastUpdatedDate>
<isUserPosted>False</isUserPosted>
<imageUrl>https://media.licdn.com/mpr/mpr/shrinknp_200_200/p/1/000/06c/2e6/1ee9687.jpg</imageUrl>
<industry>Television Stations</industry>
<industry>Broadcasting</industry>
<industry>Media & Internet</industry>
<emailAddress>######</emailAddress>
<directPhone>######</directPhone>
<isPast>False</isPast>
<referencesCount>535</referencesCount>
<currentEmployment>
<jobTitle>President and Chief Executive Officer</jobTitle>
<company>
<companyId>42483953</companyId>
<zoomCompanyUrl>http://www.zoominfo.com/s/#!search/profile/company?companyId=42483953&targetid=profile</zoomCompanyUrl>
<companyDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?CompanyID=42483953&pc=ZoomTestQA&key=4653d9b6-ace3-44b9-ad3c-f90606597817</companyDetailXmlUrl>
<companyName>WNYC</companyName>
<companyPhone>(646) 829-4400</companyPhone>
</company>
</currentEmployment>
</personRecord>
<personRecord>
<personId>510001418</personId>
<zoomPersonUrl>http://www.zoominfo.com/s/#!search/profile/person?personId=510001418&targetid=profile</zoomPersonUrl>
<personDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/person/detail?PersonID=510001418&pc=ZoomTestQA&key=4653d9b6-ace3-44b9-ad3c-f90606597817</personDetailXmlUrl>
<firstName>Josh</firstName>
<lastName>Cradduck</lastName>
<lastUpdatedDate>2018-05-04</lastUpdatedDate>
<isUserPosted>False</isUserPosted>
<imageUrl>https://media.licdn.com/mpr/mpr/shrinknp_200_200/AAEAAQAAAAAAAAejAAAAJDg0YTE0ZWQzLTVhYjUtNGQwZS05OGRiLWMwY2Q1MzFlN2Y2Ng.jpg</imageUrl>
<industry>Cable & Satellite</industry>
<industry>Telecommunications</industry>
<industry>Television Stations</industry>
<industry>Broadcasting</industry>
<industry>Media & Internet</industry>
<industry>Telephony & Wireless</industry>
<emailAddress>######</emailAddress>
<directPhone>######</directPhone>
<isPast>False</isPast>
<referencesCount>28</referencesCount>
<currentEmployment>
<jobTitle>Manager, Assignment Manager</jobTitle>
<company>
<companyId>24169680</companyId>
<zoomCompanyUrl>http://www.zoominfo.com/s/#!search/profile/company?companyId=24169680&targetid=profile</zoomCompanyUrl>
<companyDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?CompanyID=24169680&pc=ZoomTestQA&key=4653d9b6-ace3-44b9-ad3c-f90606597817</companyDetailXmlUrl>
<companyName>Charter Communications Inc</companyName>
<companyPhone>(314) 394-2500</companyPhone>
<companyFax>######</companyFax>
</company>
</currentEmployment>
</personRecord>
</peopleSearchResults>
</personSearchResponse>
Person Search returns a list of people in ZoomInfo's data who meet the search criteria. Output parameter descriptions are grouped as follows:
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 |
EmailAddress |
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 |
Contact our award-winning customer care team.