Recherche de personnes similaires

Rechercher des personnes similaires

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": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
  "details": {}
}

{
  "error": "Request rate limit exceeded. Please wait and try again later."
}

{
  "error": "An unexpected error occurred on the server."
}

POST

people

similar

Rechercher des personnes similaires

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": "Errors and codes will vary depending on the scenario, please see the documentation for information.",
  "details": {}
}

{
  "error": "Request rate limit exceeded. Please wait and try again later."
}

{
  "error": "An unexpected error occurred on the server."
}

Autorisations

pubrio-api-key

string

header

requis

Un jeton API unique qui représente les actions que vous effectuez via l'API ainsi que les autorisations et opérations correspondantes. Vous pouvez le créer dans la section Settings.

Corps

application/json

peoples

string<uuid>[]

requis

Une liste d'identifiants uniques (people_search_id) utilisée pour les opérations de recherche de personnes.

people_search_id

string

Identifiant Pubrio de la personne à utiliser comme référence.

linkedin_url

string

Une URL de profil LinkedIn unique à utiliser comme référence.

identifier

string

Une chaîne de référence libre (nom, intitulé ou URL de profil) pour amorcer la recherche de similarité.

search_term

string

Une chaîne de mots sur laquelle filtrer les résultats.

Exemple:

"pubrio"

people_name

string

Filtre les résultats de recherche pour inclure un nom de personne spécifique.

Exemple:

"king"

people_titles

string[]

Intitulés de poste associés aux personnes que vous cherchez à localiser.

Les résultats incluront également les intitulés de poste comportant une terminologie similaire, même s'ils ne correspondent pas exactement. Par exemple, une recherche pour software engineer peut renvoyer des résultats pour des personnes portant le titre senior software engineer.

Exemple:

["sales manager", "marketing manager"]

management_levels

enum<string>[]

Niveau hiérarchique de la personne. Le slug pour la direction générale est c_suite, et non c_level. Les slugs inconnus sont abandonnés lorsque d'autres filtres de personnes sont présents, et échouent avec 40037 lorsqu'il s'agit du seul filtre. Liste complète disponible via le point de terminaison management level sous Filters.

Options disponibles:

c_suite,

director,

entry,

founder,

head,

intern,

manager,

owner,

partner,

senior,

vp

Exemple:

["c_suite", "vp"]

departments

string[]

Le champ department permet de rechercher des personnes dans des domaines d'expertise spécifiques.

Consultez les points de terminaison department sous l'onglet Filters pour plus d'informations.

Exemple:

["master_human_resources"]

department_functions

string[]

Le champ de filtre pour les fonctions professionnelles permet de spécifier des rôles ou des domaines d'expertise particuliers lors de la recherche de personnes.

Consultez les points de terminaison department functions sous l'onglet Filters pour plus d'informations.

Exemple:

["human_resources"]

employees

string[][]

La plage numérique d'employés travaillant pour l'entreprise. Cela vous permet de trouver des entreprises en fonction de leur effectif. Vous pouvez ajouter plusieurs plages pour élargir vos résultats de recherche.

Consultez les points de terminaison company size sous l'onglet Filters pour plus d'informations.

Exemple:

[[1, 10], [11, 20], [10001]]

people_locations

string[]

Le lieu où résident les personnes. Consultez les points de terminaison location sous l'onglet Filters pour plus d'informations.

Exemple:

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

company_locations

string[]

L'emplacement du siège social de l'entreprise. Consultez les points de terminaison location sous l'onglet Filters pour plus d'informations.

Exemple:

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

company_linkedin_urls

string[]

L'URL complète du profil d'entreprise LinkedIn. L'URL commence par http et contient linkedin.com/company/

Exemple:

["https://www.linkedin.com/company/pubrio"]

linkedin_urls

string[]

L'URL complète du profil utilisateur LinkedIn. L'URL commence par http et contient linkedin.com/in/ ou linkedin.com/pub/

Exemple:

[
  "http://www.linkedin.com/in/king-lai-605382b7"
]

companies

string<uuid>[]

Une liste d'identifiants uniques (domain_search_id) utilisée pour les opérations de recherche d'entreprises et de personnes.

domains

string[]

Liste de domaines d'entreprise utilisée pour les opérations de recherche d'entreprises et de personnes. Si nous recevons une URL telle que www.pubrio.com ou https://docs.pubrio.com/, le système la convertira en pubrio.com pour le traitement.

Exemple:

["pubrio.com"]

filter_conditions

object[]

Surcharge AND/OR par clé pour les filtres dans /people/search. Par défaut sur OR lorsqu'omis. Consultez le guide développeur People + Company Filters pour la référence complète de remappage des clés.

Show child attributes

is_enable_similarity_search

boolean

Lorsqu'activé, les filtres listés ci-dessus qui prennent en charge les recherches par similarité peuvent être remplis avec du texte libre au lieu d'ID spécifiques.

similarity_score

number<float>

Utilisé conjointement avec is_enable_similarity_search. Ce nombre sert à déterminer si un slug spécifique (par ex. secteur vertical, technologie) est similaire à la saisie de l'utilisateur ; plus le nombre est élevé, plus l'exigence est stricte.

Exemple:

0.7

per_page

integer

défaut:25

Enregistrements par page. Par défaut 25, ce qui constitue également le plafond sur la plupart des forfaits — la limite correspond au max_search_per_page de votre abonnement, renvoyé par Profile. Le dépasser renvoie HTTP 416 avec le code 41676 (ou 41613 pour la recherche d'entreprises et de personnes), et non un ensemble de résultats tronqué.

Plage requise: x <= 25

Exemple:

25

page

integer

défaut:1

Numéro de page, à partir de 1. Le plafond correspond au max_search_page de votre abonnement (max_company_search_page pour la recherche d'entreprises), renvoyé par Profile. Le dépasser renvoie HTTP 416.

Exemple:

1

company_filters

object

Objet conteneur pour les filtres au niveau de l'entreprise. Regroupement recommandé qui sépare visuellement les clés filtrant la personne (premier niveau) de celles filtrant l'entreprise. Accepte les mêmes clés que les filtres d'entreprise de premier niveau (par ex. 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, ainsi que filter_conditions). Le moteur aplatit cet objet au premier niveau avant traitement — les clés de premier niveau l'emportent en cas de conflit. Même structure utilisée par company_filters de Monitor. Consultez le guide développeur Filters Overview pour des exemples.

Exemple:

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

Réponse

Réponse réussie contenant les détails de la recherche de personnes.

metadata

object

Contexte de la requête — reprend les filters et parameters envoyés, ainsi qu'un bloc profile avec credit, topup_credit et total_credit_cost lorsque la comptabilisation des crédits est demandée.

data

object | null

Les informations de réponse dépendent du point de terminaison spécifique.

Dernière modification le 4 septembre 2026

Documentation API

Point de terminaison

Autorisations

Corps

Réponse