메인 콘텐츠로 건너뛰기
POST
/
people
/
search
인물 검색
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"
  ],
  "company_filters": {
    "company_locations": [
      "US"
    ],
    "technologies": [
      37,
      152
    ],
    "founded_dates": [
      2015,
      2023
    ],
    "filter_conditions": [
      {
        "key": "technologies",
        "operator": "and"
      }
    ]
  },
  "filter_conditions": [
    {
      "key": "technologies",
      "operator": "and"
    }
  ],
  "is_enable_similarity_search": true,
  "similarity_score": 0.7,
  "per_page": 25,
  "page": 1,
  "query": "decision makers in marketing",
  "is_include_similar_people_titles": true,
  "people_title_similarity_score": 0.9,
  "profile_id": 123
}
'
import requests

url = "https://api.pubrio.com/people/search"

payload = {
"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"],
"company_filters": {
"company_locations": ["US"],
"technologies": [37, 152],
"founded_dates": [2015, 2023],
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
]
},
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
],
"is_enable_similarity_search": True,
"similarity_score": 0.7,
"per_page": 25,
"page": 1,
"query": "decision makers in marketing",
"is_include_similar_people_titles": True,
"people_title_similarity_score": 0.9,
"profile_id": 123
}
headers = {
"pubrio-api-key": "<api-key>",
"Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'POST',
headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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'],
company_filters: {
company_locations: ['US'],
technologies: [37, 152],
founded_dates: [2015, 2023],
filter_conditions: [{key: 'technologies', operator: 'and'}]
},
filter_conditions: [{key: 'technologies', operator: 'and'}],
is_enable_similarity_search: true,
similarity_score: 0.7,
per_page: 25,
page: 1,
query: 'decision makers in marketing',
is_include_similar_people_titles: true,
people_title_similarity_score: 0.9,
profile_id: 123
})
};

fetch('https://api.pubrio.com/people/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pubrio.com/people/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'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'
],
'company_filters' => [
'company_locations' => [
'US'
],
'technologies' => [
37,
152
],
'founded_dates' => [
2015,
2023
],
'filter_conditions' => [
[
'key' => 'technologies',
'operator' => 'and'
]
]
],
'filter_conditions' => [
[
'key' => 'technologies',
'operator' => 'and'
]
],
'is_enable_similarity_search' => true,
'similarity_score' => 0.7,
'per_page' => 25,
'page' => 1,
'query' => 'decision makers in marketing',
'is_include_similar_people_titles' => true,
'people_title_similarity_score' => 0.9,
'profile_id' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"pubrio-api-key: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"strings"
"net/http"
"io"
)

func main() {

url := "https://api.pubrio.com/people/search"

payload := strings.NewReader("{\n \"search_term\": \"pubrio\",\n \"people_name\": \"king\",\n \"people_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"management_levels\": [\n \"head\"\n ],\n \"departments\": [\n \"master_human_resources\"\n ],\n \"department_functions\": [\n \"human_resources\"\n ],\n \"employees\": [\n [\n 1,\n 10\n ],\n [\n 11,\n 20\n ],\n [\n 10001\n ]\n ],\n \"people_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"company_linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"linkedin_urls\": [\n \"http://www.linkedin.com/in/king-lai-605382b7\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"company_filters\": {\n \"company_locations\": [\n \"US\"\n ],\n \"technologies\": [\n 37,\n 152\n ],\n \"founded_dates\": [\n 2015,\n 2023\n ],\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ]\n },\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ],\n \"is_enable_similarity_search\": true,\n \"similarity_score\": 0.7,\n \"per_page\": 25,\n \"page\": 1,\n \"query\": \"decision makers in marketing\",\n \"is_include_similar_people_titles\": true,\n \"people_title_similarity_score\": 0.9,\n \"profile_id\": 123\n}")

req, _ := http.NewRequest("POST", url, payload)

req.Header.Add("pubrio-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.pubrio.com/people/search")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"search_term\": \"pubrio\",\n \"people_name\": \"king\",\n \"people_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"management_levels\": [\n \"head\"\n ],\n \"departments\": [\n \"master_human_resources\"\n ],\n \"department_functions\": [\n \"human_resources\"\n ],\n \"employees\": [\n [\n 1,\n 10\n ],\n [\n 11,\n 20\n ],\n [\n 10001\n ]\n ],\n \"people_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"company_linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"linkedin_urls\": [\n \"http://www.linkedin.com/in/king-lai-605382b7\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"company_filters\": {\n \"company_locations\": [\n \"US\"\n ],\n \"technologies\": [\n 37,\n 152\n ],\n \"founded_dates\": [\n 2015,\n 2023\n ],\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ]\n },\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ],\n \"is_enable_similarity_search\": true,\n \"similarity_score\": 0.7,\n \"per_page\": 25,\n \"page\": 1,\n \"query\": \"decision makers in marketing\",\n \"is_include_similar_people_titles\": true,\n \"people_title_similarity_score\": 0.9,\n \"profile_id\": 123\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.pubrio.com/people/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"search_term\": \"pubrio\",\n \"people_name\": \"king\",\n \"people_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"management_levels\": [\n \"head\"\n ],\n \"departments\": [\n \"master_human_resources\"\n ],\n \"department_functions\": [\n \"human_resources\"\n ],\n \"employees\": [\n [\n 1,\n 10\n ],\n [\n 11,\n 20\n ],\n [\n 10001\n ]\n ],\n \"people_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"company_linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"linkedin_urls\": [\n \"http://www.linkedin.com/in/king-lai-605382b7\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"company_filters\": {\n \"company_locations\": [\n \"US\"\n ],\n \"technologies\": [\n 37,\n 152\n ],\n \"founded_dates\": [\n 2015,\n 2023\n ],\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ]\n },\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ],\n \"is_enable_similarity_search\": true,\n \"similarity_score\": 0.7,\n \"per_page\": 25,\n \"page\": 1,\n \"query\": \"decision makers in marketing\",\n \"is_include_similar_people_titles\": true,\n \"people_title_similarity_score\": 0.9,\n \"profile_id\": 123\n}"

response = http.request(request)
puts response.read_body
{
  "metadata": {
    "filters": {
      "management_levels": [
        "c_suite"
      ]
    },
    "profile": null
  },
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 199616132,
      "total_pages": 100,
      "total_display_pages": 100,
      "is_timeout": false
    },
    "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.",
        "tagline": null,
        "introduction": null,
        "description": null,
        "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"
          }
        ],
        "country": "United States",
        "country_code": "US",
        "location": "United States",
        "state": "Arkansas",
        "city": "Bentonville",
        "wantedly_name": null,
        "rocketpunch_name": null,
        "contacts": null,
        "contact_types": [],
        "emails": null,
        "phones": null,
        "facebook_url": null,
        "github_url": null,
        "twitter_url": null,
        "linkedin_url": "http://www.linkedin.com/in/dougmcmillon",
        "wantedly_url": null,
        "rocketpunch_url": null,
        "saved_lists": null,
        "sequences": null,
        "social_metadata": {},
        "company": {
          "company_name": "Walmart",
          "company_url": "http://walmart.com",
          "is_company_url_active": true,
          "domain": "walmart.com",
          "domain_id": 26067151,
          "domain_ids": [
            757023267,
            368242703,
            26067151
          ],
          "domain_search_id": "2a0d6cd7-cc10-44d6-94ec-41fd528a11b6",
          "founded_year": 1962,
          "country": "United States",
          "country_code": "US",
          "location": "United States",
          "phones": null,
          "emails": [],
          "contacts": [],
          "wantedly_name": null,
          "rocketpunch_name": null,
          "tiktok_name": null,
          "company_size_printed": "466,000",
          "company_size": 466000,
          "industry": "Retail",
          "specialties": [
            "Retail",
            "E-commerce"
          ],
          "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",
          "x_url": null,
          "github_url": null,
          "tiktok_url": null,
          "wantedly_url": null,
          "rocketpunch_url": null,
          "social_metadata": {}
        }
      },
      "..."
    ]
  }
}
{
"code": 40001,
"message": "오류 코드 및 메시지는 상황에 따라 다를 수 있습니다. 자세한 내용은 문서를 참조하세요.",
"details": {}
}
{
"error": "요청 빈도가 제한을 초과했습니다. 잠시 후 다시 시도해주세요."
}
{
"error": "요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다"
}

인증

pubrio-api-key
string
header
필수

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

본문

application/json
search_term
string

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

예시:

"pubrio"

people_name
string

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

예시:

"king"

people_titles
string[]

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

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

예시:
["sales manager", "marketing manager"]
peoples
string<uuid>[]

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

management_levels
string[]

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

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

예시:
["head"]
departments
string[]

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

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

예시:
["master_human_resources"]
department_functions
string[]

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

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

예시:
["human_resources"]
employees
string[][]

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

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

예시:
[[1, 10], [11, 20], [10001]]
people_locations
string[]

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

예시:
["US", "SG", "CN"]
company_locations
string[]

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

예시:
["US", "SG", "CN"]
company_linkedin_urls
string[]

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

예시:
["https://www.linkedin.com/company/pubrio"]
linkedin_urls
string[]

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

예시:
[
"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으로 변환하여 처리합니다.

예시:
["pubrio.com"]
company_filters
object

회사 수준 필터의 래퍼 객체. 권장 그룹화 — 어떤 키가 인물 을 필터하고(최상위) 어떤 키가 회사 를 필터하는지를 시각적으로 분리합니다. 최상위 회사 필터와 동일한 키를 받습니다(예: technologiesverticalsvertical_categoriesvertical_sub_categoriescategorieskeywordsfounded_datesemployeesrevenuescompany_locationscompany_exclude_locationscompany_placescompany_exclude_placescompaniesdomainscompany_linkedin_urlsis_enable_similarity_searchsimilarity_score 그리고 filter_conditions). 엔진은 처리 전에 이 객체를 최상위로 평탄화합니다 — 동일 키가 있으면 최상위 키가 우선합니다. Monitor company_filters 와 같은 형태입니다. 예시는 필터 개요 개발자 가이드를 참조하세요.

예시:
{
"company_locations": ["US"],
"technologies": [37, 152],
"founded_dates": [2015, 2023],
"filter_conditions": [
{ "key": "technologies", "operator": "and" }
]
}
filter_conditions
object[]

/people/search 의 필터에 대한 키별 AND/OR 재정의. 생략 시 기본값은 OR. 전체 키 리매핑 레퍼런스는 “인물 + 회사 필터” 개발자 가이드를 참조하세요.

활성화 시, 유사도 검색을 지원하는 필터에서 자유 텍스트로 특정 ID를 조회할 수 있습니다.

similarity_score
number<float>

is_enable_similarity_search와 함께 사용됩니다. 이 값은 특정 slug(예: 산업, 기술)와 사용자 입력 간의 유사도를 분석하며, 값이 높을수록 일치율이 더 정확합니다.

예시:

0.7

per_page
integer

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

예시:

25

page
integer

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

예시:

1

query
string

자연어 검색. 입력하면 Pubrio가 이를 아래의 인물 및 회사 필터(직무, 직급, 부서, 지역, 산업, 회사 규모 등)로 해석합니다. 함께 전달한 명시적 필터가 해석된 필터보다 우선합니다. 비워 두면 구조화된 필터만으로 검색합니다.

예시:

"decision makers in marketing"

is_include_similar_people_titles
boolean

활성화하면 people_titles가 정확히 일치하는 직함뿐 아니라 유사한 직함(예: software engineersenior software engineer와 일치)도 매칭합니다.

people_title_similarity_score
number<float>

is_include_similar_people_titles와 함께 사용합니다. 직함이 얼마나 근접하게 일치해야 하는지를 제어하며, 값이 클수록 더 엄격하게 일치합니다.

예시:

0.9

profile_id
integer

선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상 필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다.

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

응답

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

data
object | null

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