Skip to main content
POST
/
people
/
search
cURL
curl --request POST \
  --url https://api.pubrio.com/people/search \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '{
  "search_term": "pubrio",
  "people_name": "king",
  "people_titles": [
    "sales manager",
    "marketing manager"
  ],
  "peoples": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "management_levels": [
    "head"
  ],
  "departments": [
    "master_human_resources"
  ],
  "department_functions": [
    "human_resources"
  ],
  "employees": [
    [
      1,
      10
    ],
    [
      11,
      20
    ],
    [
      10001
    ]
  ],
  "people_locations": [
    "US",
    "SG",
    "CN"
  ],
  "company_locations": [
    "US",
    "SG",
    "CN"
  ],
  "company_linkedin_urls": [
    "https://www.linkedin.com/company/pubrio"
  ],
  "linkedin_urls": [
    "http://www.linkedin.com/in/king-lai-605382b7"
  ],
  "companies": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "domains": [
    "pubrio.com"
  ],
  "per_page": 25,
  "page": 1,
  "profile_id": 123
}'
{
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 199616132,
      "total_pages": 100
    },
    "peoples": [
      {
        "people_search_id": "134591fb-f0fa-41ba-9c8c-f1eb8aab8946",
        "name": "Doug McMillon",
        "first_name": "Doug",
        "last_name": "McMillon",
        "title": "President & CEO",
        "seniority": "c_suite",
        "functions": null,
        "headline": "President & CEO at Walmart Inc.",
        "departments": [
          "c_suite"
        ],
        "subdepartments": [
          "executive"
        ],
        "keywords": null,
        "employment_history": [
          {
            "title": "President & CEO",
            "current": true,
            "end_date": null,
            "start_date": "2014-02-01",
            "company_name": "Walmart"
          },
          {
            "title": "President & CEO, Walmart International",
            "current": false,
            "end_date": "2014-01-01",
            "start_date": "2009-02-01",
            "company_name": "Walmart"
          },
          {
            "title": "President & CEO",
            "current": false,
            "end_date": "2009-01-01",
            "start_date": "2005-08-01",
            "company_name": "Sam's Club"
          }
        ],
        "location": "United States",
        "state": "Arkansas",
        "city": "Bentonville",
        "contacts": null,
        "emails": null,
        "phones": null,
        "facebook_url": null,
        "github_url": null,
        "twitter_url": null,
        "linkedin_url": "http://www.linkedin.com/in/dougmcmillon",
        "saved_lists": null,
        "company": {
          "company_name": "Walmart",
          "company_url": "http://walmart.com",
          "domain_id": 26067151,
          "domain_ids": [
            757023267,
            368242703,
            26067151
          ],
          "domain_search_id": "2a0d6cd7-cc10-44d6-94ec-41fd528a11b6",
          "founded_year": 1962,
          "location": "United States",
          "phones": null,
          "company_size_printed": "466,000",
          "company_size": 466000,
          "industry": "Retail",
          "logo_url": "https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg",
          "linkedin_url": "http://www.linkedin.com/company/walmart",
          "facebook_url": "http://facebook.com/walmart",
          "twitter_url": "https://twitter.com/walmart",
          "crunchbase_url": null,
          "instagram_url": "http://instagram.com/walmart",
          "youtube_url": "http://youtube.com/user/walmart"
        }
      },
      "..."
    ]
  }
}

Authorizations

​
pubrio-api-key
string
header
required

A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the Settings section.

Body

application/json
​
profile_id
integer
required

An identifier for the user profile (workspace) making the request. This ID helps in associating the lookup with a specific user, allowing for data retrieval and credit tracking.

Check out user details endpoints under the Profile tab for more information.

​
search_term
string

A string of words over which we want to filter the results.

Example:

"pubrio"

​
people_name
string

Filter search results to include a specific people name.

Example:

"king"

​
people_titles
string[]

Job titles associated with the individuals you aim to locate.

The results will also encompass job titles that include similar terminology, even if they do not match exactly. For instance, searching for software engineer may yield results for individuals with the title senior software engineer.

Example:
["sales manager", "marketing manager"]
​
peoples
string<uuid>[]

A list of unique identifiers (people_search_id) used for people search operations.

​
management_levels
string[]

The management level that individuals occupy within their current organization. This allows you to locate people who currently hold roles at specific reporting tiers, such as C level or senior level.

Check out management level endpoints under the Filters tab for more information.

Example:
["head"]
​
departments
string[]

The department field can search for people in specific areas of expertise.

Check out department endpoints under the Filters tab for more information.

Example:
["master_human_resources"]
​
department_functions
string[]

The filter field for job functions can specify particular roles or areas of expertise when searching for people.

Check out department functions endpoints under the Filters tab for more information.

Example:
["human_resources"]
​
employees
string[][]

The number range of employees working for the company. This enables you to find companies based on headcount. You can add multiple ranges to expand your search results.

Check out company size endpoints under the Filters tab for more information.

Example:
[[1, 10], [11, 20], [10001]]
​
people_locations
string[]

The location where people live. Check out location endpoints under the Filters tab for more information.

Example:
["US", "SG", "CN"]
​
company_locations
string[]

The location of the company headquarters. Check out location endpoints under the Filters tab for more information.

Example:
["US", "SG", "CN"]
​
company_linkedin_urls
string[]

The fully formed URL of the LinkedIn company profile. URL begin with http and contain linkedin.com/company/

Example:
["https://www.linkedin.com/company/pubrio"]
​
linkedin_urls
string[]

The fully formed URL of the LinkedIn user profile. URL begin with http and contain linkedin.com/in/ or linkedin.com/pub/

Example:
[
  "http://www.linkedin.com/in/king-lai-605382b7"
]
​
companies
string<uuid>[]

A list of unique identifiers (domain_search_id) used for company and people search operations.

​
domains
string[]

List of company domains used for company and people search operations. If we receive a URL such as www.pubrio.com or https://docs.pubrio.com/, the system will convert it to pubrio.com for processing.

Example:
["pubrio.com"]
​
per_page
integer

The number of search results that should be returned for each page. Limited the number of results per page improves the endpoint's performance.

Example:

25

​
page
integer

The page number of the Pubrio data that you want to retrieve.

Example:

1

Response

Successful response containing people search details.

​
data
object | null

Response info depends on specific endpoint.