Ähnliche Personen suchen - Pubrio Documentation

Nach ähnlichen Personen suchen

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

Nach ähnlichen Personen suchen

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."
}

Autorisierungen

pubrio-api-key

string

header

erforderlich

Ein eindeutiges API-Token, das die von Ihnen über die API durchgeführten Aktionen sowie die zugehörigen Berechtigungen und Vorgänge repräsentiert. Sie können es über den Bereich Settings erstellen.

Body

application/json

peoples

string<uuid>[]

erforderlich

Eine Liste eindeutiger Kennungen (people_search_id) für Personensuchvorgänge.

people_search_id

string

Pubrio-Personen-ID, die als Referenz verwendet werden soll.

linkedin_url

string

Eine einzelne LinkedIn-Profil-URL, die als Referenz verwendet werden soll.

identifier

string

Eine frei formulierte Referenzzeichenfolge (Name, Titel oder Profil-URL), um die Ähnlichkeitssuche zu initiieren.

search_term

string

Eine Wortfolge, nach der die Ergebnisse gefiltert werden sollen.

Beispiel:

"pubrio"

people_name

string

Filtert Suchergebnisse, um einen bestimmten Personennamen einzuschließen.

Beispiel:

"king"

people_titles

string[]

Berufsbezeichnungen der Personen, die Sie finden möchten.

Die Ergebnisse umfassen auch Berufsbezeichnungen mit ähnlicher Terminologie, selbst wenn diese nicht exakt übereinstimmen. Eine Suche nach software engineer kann beispielsweise Ergebnisse für Personen mit der Bezeichnung senior software engineer liefern.

Beispiel:

["sales manager", "marketing manager"]

management_levels

enum<string>[]

Hierarchieebene der Person. Der Slug für die Geschäftsführungsebene ist c_suite, nicht c_level. Unbekannte Slugs werden verworfen, wenn weitere Personenfilter vorhanden sind, und führen zu einem Fehler 40037, wenn dies der einzige Filter ist. Vollständige Liste über den Endpunkt management level im Filters-Tab.

Verfügbare Optionen:

c_suite,

director,

entry,

founder,

head,

intern,

manager,

owner,

partner,

senior,

vp

Beispiel:

["c_suite", "vp"]

departments

string[]

Das Feld „department“ ermöglicht die Suche nach Personen in bestimmten Fachbereichen.

Weitere Informationen finden Sie über die Endpunkte department im Filters-Tab.

Beispiel:

["master_human_resources"]

department_functions

string[]

Das Filterfeld für Job-Funktionen ermöglicht die Angabe bestimmter Rollen oder Fachbereiche bei der Personensuche.

Weitere Informationen finden Sie über die Endpunkte department functions im Filters-Tab.

Beispiel:

["human_resources"]

employees

string[][]

Der Zahlenbereich der für das Unternehmen tätigen Mitarbeiter. Damit können Sie Unternehmen anhand der Mitarbeiterzahl finden. Sie können mehrere Bereiche hinzufügen, um Ihre Suchergebnisse zu erweitern.

Weitere Informationen finden Sie über die Endpunkte company size im Filters-Tab.

Beispiel:

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

people_locations

string[]

Der Wohnort der Personen. Weitere Informationen finden Sie über die Endpunkte location im Filters-Tab.

Beispiel:

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

company_locations

string[]

Der Standort des Unternehmenshauptsitzes. Weitere Informationen finden Sie über die Endpunkte location im Filters-Tab.

Beispiel:

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

company_linkedin_urls

string[]

Die vollständige URL des LinkedIn-Unternehmensprofils. Die URL beginnt mit http und enthält linkedin.com/company/

Beispiel:

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

linkedin_urls

string[]

Die vollständige URL des LinkedIn-Nutzerprofils. Die URL beginnt mit http und enthält linkedin.com/in/ oder linkedin.com/pub/

Beispiel:

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

companies

string<uuid>[]

Eine Liste eindeutiger Kennungen (domain_search_id) für Unternehmens- und Personensuchvorgänge.

domains

string[]

Liste von Unternehmensdomains für Unternehmens- und Personensuchvorgänge. Erhalten wir eine URL wie www.pubrio.com oder https://docs.pubrio.com/, wandelt das System diese zur Verarbeitung in pubrio.com um.

Beispiel:

["pubrio.com"]

filter_conditions

object[]

Schlüsselspezifische AND/OR-Überschreibung für Filter in /people/search. Standardmäßig OR, wenn weggelassen. Die vollständige Referenz zur Schlüsselzuordnung finden Sie im Entwicklerleitfaden „People + Company Filters“.

Show child attributes

is_enable_similarity_search

boolean

Bei Aktivierung können die oben aufgeführten Filter, die Ähnlichkeitssuchen unterstützen, anstelle bestimmter IDs mit Freitext befüllt werden.

similarity_score

number<float>

Wird in Verbindung mit is_enable_similarity_search verwendet. Diese Zahl dient dazu, zu analysieren, ob ein bestimmter Slug (z. B. Branche, Technologie) der Nutzereingabe ähnelt; je höher die Zahl, desto strenger ist die Prüfung.

Beispiel:

0.7

per_page

integer

Standard:25

Datensätze pro Seite. Standardmäßig 25, was bei den meisten Tarifen auch die Obergrenze ist — das Limit ist der max_search_per_page-Wert Ihres Abonnements, zurückgegeben von Profile. Bei Überschreitung wird HTTP 416 mit dem Code 41676 (oder 41613 bei der Unternehmens- und Personensuche) zurückgegeben, keine begrenzte Ergebnismenge.

Erforderlicher Bereich: x <= 25

Beispiel:

25

page

integer

Standard:1

Seitenzahl, beginnend bei 1. Die Obergrenze ist der max_search_page-Wert Ihres Abonnements (max_company_search_page für die Unternehmenssuche), zurückgegeben von Profile. Bei Überschreitung wird HTTP 416 zurückgegeben.

Beispiel:

1

company_filters

object

Wrapper-Objekt für Filter auf Unternehmensebene. Empfohlene Gruppierung, die visuell trennt, welche Schlüssel die Person (oberste Ebene) filtern und welche das Unternehmen filtern. Akzeptiert dieselben Schlüssel wie die Unternehmensfilter auf oberster Ebene (z. B. 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, sowie filter_conditions). Die Engine flacht dieses Objekt vor der Verarbeitung auf die oberste Ebene ab – bei Konflikten gewinnen die Schlüssel der obersten Ebene. Dieselbe Struktur wird bei Monitor company_filters verwendet. Beispiele finden Sie im Entwicklerleitfaden „Filters Overview“.

Beispiel:

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

Antwort

Erfolgreiche Antwort mit Details zur Personensuche.

metadata

object

Anfragekontext – gespiegelte filters und parameters, plus ein profile-Block mit credit, topup_credit und total_credit_cost, wenn eine Credit-Abrechnung angefordert wird.

data

object | null

Die Antwortinformationen hängen vom jeweiligen Endpunkt ab.

Zuletzt geändert am 4. September 2026