類似人物を検索 - Pubrio Documentation

類似人物を検索

curl --request POST \
  --url https://api.pubrio.com/people/search/similar \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "peoples": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "people_search_id": "<string>",
  "linkedin_url": "<string>",
  "identifier": "<string>",
  "search_term": "pubrio",
  "people_name": "king",
  "people_titles": [
    "sales manager",
    "marketing manager"
  ],
  "management_levels": [
    "c_suite",
    "vp"
  ],
  "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,
  "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 = {
    "peoples": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "people_search_id": "<string>",
    "linkedin_url": "<string>",
    "identifier": "<string>",
    "search_term": "pubrio",
    "people_name": "king",
    "people_titles": ["sales manager", "marketing manager"],
    "management_levels": ["c_suite", "vp"],
    "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,
    "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({
    peoples: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    people_search_id: '<string>',
    linkedin_url: '<string>',
    identifier: '<string>',
    search_term: 'pubrio',
    people_name: 'king',
    people_titles: ['sales manager', 'marketing manager'],
    management_levels: ['c_suite', 'vp'],
    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,
    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([
    'peoples' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'people_search_id' => '<string>',
    'linkedin_url' => '<string>',
    'identifier' => '<string>',
    'search_term' => 'pubrio',
    'people_name' => 'king',
    'people_titles' => [
        'sales manager',
        'marketing manager'
    ],
    'management_levels' => [
        'c_suite',
        'vp'
    ],
    '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,
    '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  \"peoples\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"people_search_id\": \"<string>\",\n  \"linkedin_url\": \"<string>\",\n  \"identifier\": \"<string>\",\n  \"search_term\": \"pubrio\",\n  \"people_name\": \"king\",\n  \"people_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"management_levels\": [\n    \"c_suite\",\n    \"vp\"\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  \"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  \"peoples\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"people_search_id\": \"<string>\",\n  \"linkedin_url\": \"<string>\",\n  \"identifier\": \"<string>\",\n  \"search_term\": \"pubrio\",\n  \"people_name\": \"king\",\n  \"people_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"management_levels\": [\n    \"c_suite\",\n    \"vp\"\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  \"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  \"peoples\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"people_search_id\": \"<string>\",\n  \"linkedin_url\": \"<string>\",\n  \"identifier\": \"<string>\",\n  \"search_term\": \"pubrio\",\n  \"people_name\": \"king\",\n  \"people_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"management_levels\": [\n    \"c_suite\",\n    \"vp\"\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  \"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": {}
        }
      },
      "..."
    ]
  }
}

{
  "code": 40001,
  "message": "エラーの背景やフィールド単位の情報などを含む追加データオブジェクトです。",
  "details": {}
}

{
  "error": "クライアントはしばらく待ってから再試行することが推奨されます。"
}

{
  "error": "レスポンスボディには `error` フィールドが含まれ、問題の概要がメッセージとして記載されます。"
}

POST

people

similar

類似人物を検索

curl --request POST \
  --url https://api.pubrio.com/people/search/similar \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "peoples": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "people_search_id": "<string>",
  "linkedin_url": "<string>",
  "identifier": "<string>",
  "search_term": "pubrio",
  "people_name": "king",
  "people_titles": [
    "sales manager",
    "marketing manager"
  ],
  "management_levels": [
    "c_suite",
    "vp"
  ],
  "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,
  "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 = {
    "peoples": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
    "people_search_id": "<string>",
    "linkedin_url": "<string>",
    "identifier": "<string>",
    "search_term": "pubrio",
    "people_name": "king",
    "people_titles": ["sales manager", "marketing manager"],
    "management_levels": ["c_suite", "vp"],
    "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,
    "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({
    peoples: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
    people_search_id: '<string>',
    linkedin_url: '<string>',
    identifier: '<string>',
    search_term: 'pubrio',
    people_name: 'king',
    people_titles: ['sales manager', 'marketing manager'],
    management_levels: ['c_suite', 'vp'],
    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,
    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([
    'peoples' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'people_search_id' => '<string>',
    'linkedin_url' => '<string>',
    'identifier' => '<string>',
    'search_term' => 'pubrio',
    'people_name' => 'king',
    'people_titles' => [
        'sales manager',
        'marketing manager'
    ],
    'management_levels' => [
        'c_suite',
        'vp'
    ],
    '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,
    '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  \"peoples\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"people_search_id\": \"<string>\",\n  \"linkedin_url\": \"<string>\",\n  \"identifier\": \"<string>\",\n  \"search_term\": \"pubrio\",\n  \"people_name\": \"king\",\n  \"people_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"management_levels\": [\n    \"c_suite\",\n    \"vp\"\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  \"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  \"peoples\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"people_search_id\": \"<string>\",\n  \"linkedin_url\": \"<string>\",\n  \"identifier\": \"<string>\",\n  \"search_term\": \"pubrio\",\n  \"people_name\": \"king\",\n  \"people_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"management_levels\": [\n    \"c_suite\",\n    \"vp\"\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  \"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  \"peoples\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ],\n  \"people_search_id\": \"<string>\",\n  \"linkedin_url\": \"<string>\",\n  \"identifier\": \"<string>\",\n  \"search_term\": \"pubrio\",\n  \"people_name\": \"king\",\n  \"people_titles\": [\n    \"sales manager\",\n    \"marketing manager\"\n  ],\n  \"management_levels\": [\n    \"c_suite\",\n    \"vp\"\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  \"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": {}
        }
      },
      "..."
    ]
  }
}

{
  "code": 40001,
  "message": "エラーの背景やフィールド単位の情報などを含む追加データオブジェクトです。",
  "details": {}
}

{
  "error": "クライアントはしばらく待ってから再試行することが推奨されます。"
}

{
  "error": "レスポンスボディには `error` フィールドが含まれ、問題の概要がメッセージとして記載されます。"
}

承認

pubrio-api-key

string

header

必須

API で実行する操作内容と、その操作に付与された権限を識別するための一意の API トークンです。このトークンはダッシュボードの設定画面から発行できます。

ボディ

application/json

peoples

string<uuid>[]

必須

ユーザー検索処理で利用する people_search_id の一覧です。

people_search_id

string

参照対象として使用する Pubrio の人物 ID。

linkedin_url

string

参照対象として使用する単一の LinkedIn プロフィール URL。

identifier

string

類似検索のシードとなる自由形式の参照文字列（氏名、役職、プロフィール URL）。

search_term

string

検索結果を絞り込むために使用するキーワード文字列です。

例:

"pubrio"

people_name

string

指定したユーザー名に一致する人物のみが含まれるように検索結果を絞り込みます。

例:

"king"

people_titles

string[]

対象人物に関連する役職名です。完全一致でなくても、類似する役職を含む結果が返されます（例：software engineer で senior software engineer もヒット）。

例:

["sales manager", "marketing manager"]

management_levels

enum<string>[]

人物の報告階層。経営層のスラッグは c_level ではなく c_suite です。他の人物フィルターがある場合、未知のスラッグは破棄され、唯一のフィルターなら 40037 で失敗します。全リストは Filters の management level エンドポイントから。

利用可能なオプション:

c_suite,

director,

entry,

founder,

head,

intern,

manager,

owner,

partner,

senior,

vp

例:

["c_suite", "vp"]

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[]

ユーザー（人物）の所在地を示すフィルターです。

例:

["US", "SG", "CN"]

company_locations

string[]

企業本社の所在地を示すフィルターです。

例:

["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 や URL スキームが含まれる場合も、自動的にルートドメインへ正規化されます。

例:

["pubrio.com"]

filter_conditions

object[]

/people/search におけるフィルターのキーごとの AND/OR 上書き。省略時のデフォルトは OR。完全なキー再マッピングのリファレンスは「人物 + 企業フィルター」開発者ガイドを参照してください。

Show child attributes

is_enable_similarity_search

boolean

対応するフィルターで類似度検索を有効にするフラグです。有効化すると、ID ではなく自由テキストを渡しても、内部で類似スコアに基づいて候補を解決できます。

similarity_score

number<float>

is_enable_similarity_search と併用するスコアしきい値で、業種や技術などのスラッグとユーザー入力の近さを数値で指定します。値が高いほどマッチング条件が厳しくなり、より精度の高い結果に絞り込まれます。

例:

0.7

per_page

integer

デフォルト:25

1 ページあたりの件数。既定は 25 で、多くのプランではこれが上限でもあります。制限値はサブスクリプションの max_search_per_page で、Profile から取得できます。超過すると結果が丸められるのではなく、HTTP 416 とコード 41676（企業・人物検索では 41613）が返ります。

必須範囲: x <= 25

例:

25

page

integer

デフォルト:1

ページ番号（1 から開始）。上限はサブスクリプションの max_search_page（企業検索では max_company_search_page）で、Profile から取得できます。超過すると HTTP 416 が返ります。

例:

1

company_filters

object

企業レベルフィルターのラッパーオブジェクト。推奨グループ化 — どのキーが人物を絞り(トップレベル)、どのキーが企業を絞るかを視覚的に分けます。トップレベルの企業フィルターと同じキーを受け付けます(例: 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" }
  ]
}

レスポンス

関連する詳細情報を含む成功レスポンスです。

metadata

object

リクエストのコンテキスト — エコーされた filters と parameters、およびクレジット計上を要求した場合に返る credit・topup_credit・total_credit_cost を含む profile ブロック。

data

object | null

エンドポイント固有のレスポンスをオブジェクト形式で格納する汎用コンテナです。

最終更新日 2026年4月22日