메인 콘텐츠로 건너뛰기
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 '
{
  "profile_id": 123,
  "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
}
'
{
  "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

API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은 설정 섹션에서 생성할 수 있습니다.

Body

application/json
​
profile_id
integer
required

요청을 수행하는 팀 식별자입니다. 이 ID는 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다.

자세한 내용은 팀 탭의 user details 엔드포인트를 참고하세요.

​
search_term
string

결과를 필터링하기 위한 키워드 문자열입니다.

Example:

"pubrio"

​
people_name
string

검색 결과를 지정된 사용자 이름으로 필터링합니다.

Example:

"king"

​
people_titles
string[]

검색 대상 인물의 직함입니다.

software engineer를 검색하면 senior software engineer와 같이 유사한 용어를 포함한 결과도 반환될 수 있습니다.

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

사용자 조회 작업을 위한 고유 식별자(people_search_id) 목록.

​
management_levels
string[]

현재 조직에서 인물의 관리 직급을 나타냅니다. 특정 보고 계층(예: C레벨 또는 시니어)을 대상으로 필터링할 때 사용합니다.

자세한 내용은 필터 탭의 management level 엔드포인트를 참조하세요.

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

특정 전문 분야의 인물을 검색하기 위한 부서 필드입니다.

자세한 내용은 필터 탭의 department 엔드포인트를 참조하세요.

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

직무 기능 필드는 특정 직책이나 전문 분야를 지정해 인물을 검색할 때 사용합니다.

자세한 내용은 필터 탭의 department functions 엔드포인트를 참조하세요.

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

회사 직원 수 범위입니다. 총 직원 수를 기준으로 회사를 필터링할 수 있으며, 여러 범위를 추가해 검색 결과를 확장할 수 있습니다.

자세한 내용은 필터 탭의 company size 엔드포인트를 참조하세요.

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

사용자 위치입니다. 자세한 내용은 필터 탭의 location 엔드포인트를 참고하세요.

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

회사 본사 위치입니다. 자세한 내용은 필터 탭의 location 엔드포인트를 참고하세요.

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

LinkedIn 회사 페이지의 전체 URL입니다. http로 시작하며 linkedin.com/company/를 포함해야 합니다.

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

LinkedIn 사용자 프로필의 전체 URL입니다. http로 시작하며 linkedin.com/in/ 또는 linkedin.com/pub/을 포함해야 합니다.

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

회사 및 인물 조회 작업을 위한 고유 식별자(domain_search_id) 목록.

​
domains
string[]

회사 및 인물 조회 작업에 사용되는 회사 도메인 목록입니다. 입력된 주소가 www.pubrio.com 또는 https://docs.pubrio.com/인 경우, 시스템은 이를 자동으로 pubrio.com으로 변환하여 처리합니다.

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

페이지당 반환할 검색 결과 수입니다. 결과 수를 제한하면 API 성능이 향상됩니다.

Example:

25

​
page
integer

조회할 데이터 페이지 번호입니다.

Example:

1

Response

관련 세부 정보가 포함된 성공적인 응답입니다.

​
data
object

응답 정보는 특정 API에 따라 다릅니다.