類似人物を検索
curl --request POST \
--url https://api.pubrio.com/people/search/similar \
--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"
],
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
],
"is_enable_similarity_search": true,
"similarity_score": 0.7,
"per_page": 25,
"page": 1,
"profile_id": 123,
"company_filters": {
"company_locations": [
"US"
],
"technologies": [
37,
152
],
"founded_dates": [
2015,
2023
],
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
]
}
}
'import requests
url = "https://api.pubrio.com/people/search/similar"
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"],
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
],
"is_enable_similarity_search": True,
"similarity_score": 0.7,
"per_page": 25,
"page": 1,
"profile_id": 123,
"company_filters": {
"company_locations": ["US"],
"technologies": [37, 152],
"founded_dates": [2015, 2023],
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
]
}
}
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'],
filter_conditions: [{key: 'technologies', operator: 'and'}],
is_enable_similarity_search: true,
similarity_score: 0.7,
per_page: 25,
page: 1,
profile_id: 123,
company_filters: {
company_locations: ['US'],
technologies: [37, 152],
founded_dates: [2015, 2023],
filter_conditions: [{key: 'technologies', operator: 'and'}]
}
})
};
fetch('https://api.pubrio.com/people/search/similar', 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/similar",
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'
],
'filter_conditions' => [
[
'key' => 'technologies',
'operator' => 'and'
]
],
'is_enable_similarity_search' => true,
'similarity_score' => 0.7,
'per_page' => 25,
'page' => 1,
'profile_id' => 123,
'company_filters' => [
'company_locations' => [
'US'
],
'technologies' => [
37,
152
],
'founded_dates' => [
2015,
2023
],
'filter_conditions' => [
[
'key' => 'technologies',
'operator' => 'and'
]
]
]
]),
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/similar"
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 \"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 \"profile_id\": 123,\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}")
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/similar")
.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 \"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 \"profile_id\": 123,\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}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/people/search/similar")
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 \"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 \"profile_id\": 123,\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}"
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": {}
},
"similarity_score": 0.92
},
"..."
]
}
}{
"code": 40001,
"message": "エラーの背景やフィールド単位の情報などを含む追加データオブジェクトです。",
"details": {}
}{
"error": "クライアントはしばらく待ってから再試行することが推奨されます。"
}{
"error": "レスポンスボディには `error` フィールドが含まれ、問題の概要がメッセージとして記載されます。"
}類似オーディエンス
類似人物を検索
参照人物に類似する人物を検索します。リクエストボディは POST /people/search と同じ。people_titles、people_search_id、linkedin_url、linkedin_urls、または peoples のいずれかを参照として必須。各結果行には similarity_score(0.0-1.0、高いほど近い)が含まれ、類似度の降順で並びます。
POST
/
people
/
search
/
similar
類似人物を検索
curl --request POST \
--url https://api.pubrio.com/people/search/similar \
--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"
],
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
],
"is_enable_similarity_search": true,
"similarity_score": 0.7,
"per_page": 25,
"page": 1,
"profile_id": 123,
"company_filters": {
"company_locations": [
"US"
],
"technologies": [
37,
152
],
"founded_dates": [
2015,
2023
],
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
]
}
}
'import requests
url = "https://api.pubrio.com/people/search/similar"
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"],
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
],
"is_enable_similarity_search": True,
"similarity_score": 0.7,
"per_page": 25,
"page": 1,
"profile_id": 123,
"company_filters": {
"company_locations": ["US"],
"technologies": [37, 152],
"founded_dates": [2015, 2023],
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
]
}
}
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'],
filter_conditions: [{key: 'technologies', operator: 'and'}],
is_enable_similarity_search: true,
similarity_score: 0.7,
per_page: 25,
page: 1,
profile_id: 123,
company_filters: {
company_locations: ['US'],
technologies: [37, 152],
founded_dates: [2015, 2023],
filter_conditions: [{key: 'technologies', operator: 'and'}]
}
})
};
fetch('https://api.pubrio.com/people/search/similar', 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/similar",
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'
],
'filter_conditions' => [
[
'key' => 'technologies',
'operator' => 'and'
]
],
'is_enable_similarity_search' => true,
'similarity_score' => 0.7,
'per_page' => 25,
'page' => 1,
'profile_id' => 123,
'company_filters' => [
'company_locations' => [
'US'
],
'technologies' => [
37,
152
],
'founded_dates' => [
2015,
2023
],
'filter_conditions' => [
[
'key' => 'technologies',
'operator' => 'and'
]
]
]
]),
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/similar"
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 \"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 \"profile_id\": 123,\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}")
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/similar")
.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 \"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 \"profile_id\": 123,\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}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/people/search/similar")
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 \"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 \"profile_id\": 123,\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}"
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": {}
},
"similarity_score": 0.92
},
"..."
]
}
}{
"code": 40001,
"message": "エラーの背景やフィールド単位の情報などを含む追加データオブジェクトです。",
"details": {}
}{
"error": "クライアントはしばらく待ってから再試行することが推奨されます。"
}{
"error": "レスポンスボディには `error` フィールドが含まれ、問題の概要がメッセージとして記載されます。"
}承認
ボディ
application/json
検索結果を絞り込むために使用するキーワード文字列です。
例:
"pubrio"
指定したユーザー名に一致する人物のみが含まれるように検索結果を絞り込みます。
例:
"king"
対象人物に関連する役職名です。完全一致でなくても、類似する役職を含む結果が返されます（例：software engineer で senior software engineer もヒット）。
例:
["sales manager", "marketing manager"]
ユーザー検索処理で利用する people_search_id の一覧です。
現在の組織におけるマネジメントレベルを示します。C レベルやシニア層など、特定のレポート階層に属する人物を絞り込むために使用します。
例:
["head"]
特定の専門領域に属する人物を探すための部署情報です。詳細はフィルタータブの department エンドポイントを参照します。
例:
["master_human_resources"]
職務機能フィルターで、検索対象の職種や専門分野を指定します。詳細はフィルタータブの department functions エンドポイントを参照します。
例:
["human_resources"]
企業の従業員数レンジを表します。複数レンジを指定することで、対象となる会社規模の幅を広げられます。詳細は company size エンドポイントを参照します。
例:
[[1, 10], [11, 20], [10001]]
ユーザー（人物）の所在地を示すフィルターです。
例:
["US", "SG", "CN"]
企業本社の所在地を示すフィルターです。
例:
["US", "SG", "CN"]
企業の LinkedIn 公式ページを指す完全な URL です。値は http で始まり、linkedin.com/company/ を含んでいる必要があります。
例:
["https://www.linkedin.com/company/pubrio"]
個人の LinkedIn プロフィールを指す完全な URL です。値は http で始まり、linkedin.com/in/ または linkedin.com/pub/ を含んでいる必要があります。
例:
[ "http://www.linkedin.com/in/king-lai-605382b7" ]
企業および人物検索処理で利用する domain_search_id の一覧です。
企業および人物検索に使用する会社ドメインの一覧です。www や URL スキームが含まれる場合も、自動的にルートドメインへ正規化されます。
例:
["pubrio.com"]
/people/search におけるフィルターのキーごとの AND/OR 上書き。省略時のデフォルトは OR。完全なキー再マッピングのリファレンスは「人物 + 企業フィルター」開発者ガイドを参照してください。
Show child attributes
Show child attributes
対応するフィルターで類似度検索を有効にするフラグです。有効化すると、ID ではなく自由テキストを渡しても、内部で類似スコアに基づいて候補を解決できます。
is_enable_similarity_search と併用するスコアしきい値で、業種や技術などのスラッグとユーザー入力の近さを数値で指定します。値が高いほどマッチング条件が厳しくなり、より精度の高い結果に絞り込まれます。
例:
0.7
1 ページあたりに返される検索結果件数です。ページサイズを制限することで、レスポンス速度や API パフォーマンスの向上が期待できます。
例:
25
取得したい結果セットのページ番号です。
例:
1
オプション。リクエストを送信するチームを表す識別子です。API キーにワークスペース情報が既に含まれているため、このパラメータは必須ではなくなりました。指定した場合、検索結果が特定のチーム（ワークスペース）に紐づけられ、データ取得およびクレジット利用状況の追跡が可能になります。詳しくは、チーム関連の「ユーザー詳細」エンドポイントを参照してください。
企業レベルフィルターのラッパーオブジェクト。推奨グループ化 — どのキーが人物を絞り(トップレベル)、どのキーが企業を絞るかを視覚的に分けます。トップレベルの企業フィルターと同じキーを受け付けます(例: technologies、verticals、vertical_categories、vertical_sub_categories、categories、keywords、founded_dates、employees、revenues、company_locations、company_exclude_locations、company_places、company_exclude_places、companies、domains、company_linkedin_urls、is_enable_similarity_search、similarity_score、および filter_conditions)。エンジンは処理前にこのオブジェクトをトップレベルに展開します — 同名キーがある場合はトップレベルが勝ちます。Monitor company_filters と同じ形状です。例はフィルター概要開発者ガイドを参照してください。
例:
{ "company_locations": ["US"], "technologies": [37, 152], "founded_dates": [2015, 2023], "filter_conditions": [ { "key": "technologies", "operator": "and" } ] }
レスポンス
関連する詳細情報を含む成功レスポンスです。
エンドポイント固有のレスポンスをオブジェクト形式で格納する汎用コンテナです。
⌘I