🚫
Universal Credits are not currently available for Essentials, Pro, Ultimate plans. Please instead use: People Search API

🚨Universal Credits - Updates 🚨

The new Universal Credit system is now live. Account Managers will reach out with more details. You can find more information here: Universal Credits Overview

If you have any questions, please reach out to our team at api@rocketreach.co.

Credit Action	Credit Cost
Person Search	1 credit / page of results (up to 100 results per page)

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 '-' to your filter value to mark it as an exclude term. 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.

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_title":["Software Engineer", "Software Developer", "-Senior", "-Sr"]}}'

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"

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.