People Search API

Use our People Search API endpoint to discover and filter over 700M professional profiles by criteria such as name, company, or more.

The person search endpoint behaves similarly to the search in our UI. When you provide certain keywords, or facets as inputs, this endpoint returns a list of people. The result is always a list of possible matches, without any contact info. You can search by name, keyword, title, company or location, and more. See the full list of search parameters.

Retrieving Contact Information for Profiles

Contact information is not returned in the result. In order to retrieve contact information for someone in the list, please make a separate call to lookup that person.

A detailed flowchart for this webservice call, is shown below.

Specifying exact matches

You can specify exact matches for all your search terms. E.g. The following query matches anyone with 'Marc Benioff' in their name. I.e it will match people named both “Marc Benioff”, “Benioff Marc” and also “Marc Anthony Benioff”. It will also ignore certain typos like “Marck benoiff” etc.

    curl --request 'POST' --location 'https://api.rocketreach.co/v2/api/search'
     --header 'Api-Key: <YOUR API KEY>'
     --header 'Content-Type: application/json'
     --data '{"query":{"name":["Marc Benioff"]}}'

This query exact matches anyone with the exact name 'Marc Benioff'. To specify exact matches, add quotes around your search term

    curl --request 'POST' --location 'https://api.rocketreach.co/v2/api/search'
     --header 'Api-Key: <YOUR API KEY>'
     --header 'Content-Type: application/json'
     --data '{"query":{"name":["\"Marc Benioff\""]}}'

This approach works for all other parameters that accept strings. E.g. If you wish to exact match people with current employer: “IBM”, you can use the following query. Note that this will exclude people who work e.g. for "IBM UK".

    curl --request 'POST' --location 'https://api.rocketreach.co/v2/api/search'
     --header 'Api-Key: <YOUR API KEY>'
     --header 'Content-Type: application/json'
     --data '{"query":{"current_employer":["\"IBM\""]}}'

Exclude Search Terms

You can omit results matching any of the search terms listed in the table above. Prepend exclude_ before the field name to change the field parameter to exclude all matching documents. In this specific example, we will return the best results that match title: 'Software Engineer' and title: 'Software Developer' but not title: 'Senior' or title: 'Sr'.

Basically, this should match Software Engineers and Software Developers that don't have senior anywhere in their job title.

Numbers with Operators

Some fields, such as company_funding, take strings which are numbers with mathematical operators. For example, here are some valid values:

• "1000000+"
• "<90000000"
• "1000000>="
• "1000000-90000000"

US Diversity Fields

US Diversity fields may be used only in addition to other fields for searches. To gain access to US diversity fields please contact sales.

Location With Radius

With the location parameter, you can add a radius at the end of the location string, prepended by ::~.

Here are a couple examples:

• "location": ["\"San Francisco\"::~50mi"]
• metric is also supported: "location": ["\"San Francisco\"::~50km"]
  

Ordering

• relevance: return results most closely matching the search query.
• popularity: decision makers, executives and managers matching the search criteria are closer to the top of the search results.