Buscar personas
curl --request POST \
--url https://api.pubrio.com/people/search \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"search_term": "pubrio",
"people_name": "king",
"people_titles": [
"sales manager",
"marketing manager"
],
"exclude_people_titles": [
"intern",
"assistant"
],
"peoples": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"management_levels": [
"c_suite",
"vp"
],
"departments": [
"master_human_resources"
],
"exclude_departments": [
"master_human_resources"
],
"department_functions": [
"human_resources"
],
"exclude_department_functions": [
"software_development"
],
"employees": [
[
1,
10
],
[
11,
20
],
[
10001
]
],
"people_locations": [
"US",
"SG",
"CN"
],
"exclude_people_locations": [
"US"
],
"company_locations": [
"US",
"SG",
"CN"
],
"company_exclude_locations": [
"CN"
],
"company_linkedin_urls": [
"https://www.linkedin.com/company/pubrio"
],
"linkedin_urls": [
"http://www.linkedin.com/in/king-lai-605382b7"
],
"companies": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"domains": [
"pubrio.com"
],
"company_filters": {
"company_locations": [
"US"
],
"technologies": [
37,
152
],
"founded_dates": [
2015,
2023
],
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
]
},
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
],
"is_enable_similarity_search": true,
"similarity_score": 0.7,
"per_page": 25,
"page": 1,
"query": "decision makers in marketing",
"is_include_similar_people_titles": true,
"people_title_similarity_score": 0.9
}
'import requests
url = "https://api.pubrio.com/people/search"
payload = {
"search_term": "pubrio",
"people_name": "king",
"people_titles": ["sales manager", "marketing manager"],
"exclude_people_titles": ["intern", "assistant"],
"peoples": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"management_levels": ["c_suite", "vp"],
"departments": ["master_human_resources"],
"exclude_departments": ["master_human_resources"],
"department_functions": ["human_resources"],
"exclude_department_functions": ["software_development"],
"employees": [[1, 10], [11, 20], [10001]],
"people_locations": ["US", "SG", "CN"],
"exclude_people_locations": ["US"],
"company_locations": ["US", "SG", "CN"],
"company_exclude_locations": ["CN"],
"company_linkedin_urls": ["https://www.linkedin.com/company/pubrio"],
"linkedin_urls": ["http://www.linkedin.com/in/king-lai-605382b7"],
"companies": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"domains": ["pubrio.com"],
"company_filters": {
"company_locations": ["US"],
"technologies": [37, 152],
"founded_dates": [2015, 2023],
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
]
},
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
],
"is_enable_similarity_search": True,
"similarity_score": 0.7,
"per_page": 25,
"page": 1,
"query": "decision makers in marketing",
"is_include_similar_people_titles": True,
"people_title_similarity_score": 0.9
}
headers = {
"pubrio-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
search_term: 'pubrio',
people_name: 'king',
people_titles: ['sales manager', 'marketing manager'],
exclude_people_titles: ['intern', 'assistant'],
peoples: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
management_levels: ['c_suite', 'vp'],
departments: ['master_human_resources'],
exclude_departments: ['master_human_resources'],
department_functions: ['human_resources'],
exclude_department_functions: ['software_development'],
employees: [[1, 10], [11, 20], [10001]],
people_locations: ['US', 'SG', 'CN'],
exclude_people_locations: ['US'],
company_locations: ['US', 'SG', 'CN'],
company_exclude_locations: ['CN'],
company_linkedin_urls: ['https://www.linkedin.com/company/pubrio'],
linkedin_urls: ['http://www.linkedin.com/in/king-lai-605382b7'],
companies: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
domains: ['pubrio.com'],
company_filters: {
company_locations: ['US'],
technologies: [37, 152],
founded_dates: [2015, 2023],
filter_conditions: [{key: 'technologies', operator: 'and'}]
},
filter_conditions: [{key: 'technologies', operator: 'and'}],
is_enable_similarity_search: true,
similarity_score: 0.7,
per_page: 25,
page: 1,
query: 'decision makers in marketing',
is_include_similar_people_titles: true,
people_title_similarity_score: 0.9
})
};
fetch('https://api.pubrio.com/people/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pubrio.com/people/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'search_term' => 'pubrio',
'people_name' => 'king',
'people_titles' => [
'sales manager',
'marketing manager'
],
'exclude_people_titles' => [
'intern',
'assistant'
],
'peoples' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'management_levels' => [
'c_suite',
'vp'
],
'departments' => [
'master_human_resources'
],
'exclude_departments' => [
'master_human_resources'
],
'department_functions' => [
'human_resources'
],
'exclude_department_functions' => [
'software_development'
],
'employees' => [
[
1,
10
],
[
11,
20
],
[
10001
]
],
'people_locations' => [
'US',
'SG',
'CN'
],
'exclude_people_locations' => [
'US'
],
'company_locations' => [
'US',
'SG',
'CN'
],
'company_exclude_locations' => [
'CN'
],
'company_linkedin_urls' => [
'https://www.linkedin.com/company/pubrio'
],
'linkedin_urls' => [
'http://www.linkedin.com/in/king-lai-605382b7'
],
'companies' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'domains' => [
'pubrio.com'
],
'company_filters' => [
'company_locations' => [
'US'
],
'technologies' => [
37,
152
],
'founded_dates' => [
2015,
2023
],
'filter_conditions' => [
[
'key' => 'technologies',
'operator' => 'and'
]
]
],
'filter_conditions' => [
[
'key' => 'technologies',
'operator' => 'and'
]
],
'is_enable_similarity_search' => true,
'similarity_score' => 0.7,
'per_page' => 25,
'page' => 1,
'query' => 'decision makers in marketing',
'is_include_similar_people_titles' => true,
'people_title_similarity_score' => 0.9
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"pubrio-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.pubrio.com/people/search"
payload := strings.NewReader("{\n \"search_term\": \"pubrio\",\n \"people_name\": \"king\",\n \"people_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"exclude_people_titles\": [\n \"intern\",\n \"assistant\"\n ],\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"management_levels\": [\n \"c_suite\",\n \"vp\"\n ],\n \"departments\": [\n \"master_human_resources\"\n ],\n \"exclude_departments\": [\n \"master_human_resources\"\n ],\n \"department_functions\": [\n \"human_resources\"\n ],\n \"exclude_department_functions\": [\n \"software_development\"\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 \"exclude_people_locations\": [\n \"US\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"company_exclude_locations\": [\n \"CN\"\n ],\n \"company_linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"linkedin_urls\": [\n \"http://www.linkedin.com/in/king-lai-605382b7\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"company_filters\": {\n \"company_locations\": [\n \"US\"\n ],\n \"technologies\": [\n 37,\n 152\n ],\n \"founded_dates\": [\n 2015,\n 2023\n ],\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ]\n },\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ],\n \"is_enable_similarity_search\": true,\n \"similarity_score\": 0.7,\n \"per_page\": 25,\n \"page\": 1,\n \"query\": \"decision makers in marketing\",\n \"is_include_similar_people_titles\": true,\n \"people_title_similarity_score\": 0.9\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("pubrio-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.pubrio.com/people/search")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"search_term\": \"pubrio\",\n \"people_name\": \"king\",\n \"people_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"exclude_people_titles\": [\n \"intern\",\n \"assistant\"\n ],\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"management_levels\": [\n \"c_suite\",\n \"vp\"\n ],\n \"departments\": [\n \"master_human_resources\"\n ],\n \"exclude_departments\": [\n \"master_human_resources\"\n ],\n \"department_functions\": [\n \"human_resources\"\n ],\n \"exclude_department_functions\": [\n \"software_development\"\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 \"exclude_people_locations\": [\n \"US\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"company_exclude_locations\": [\n \"CN\"\n ],\n \"company_linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"linkedin_urls\": [\n \"http://www.linkedin.com/in/king-lai-605382b7\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"company_filters\": {\n \"company_locations\": [\n \"US\"\n ],\n \"technologies\": [\n 37,\n 152\n ],\n \"founded_dates\": [\n 2015,\n 2023\n ],\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ]\n },\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ],\n \"is_enable_similarity_search\": true,\n \"similarity_score\": 0.7,\n \"per_page\": 25,\n \"page\": 1,\n \"query\": \"decision makers in marketing\",\n \"is_include_similar_people_titles\": true,\n \"people_title_similarity_score\": 0.9\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/people/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"search_term\": \"pubrio\",\n \"people_name\": \"king\",\n \"people_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"exclude_people_titles\": [\n \"intern\",\n \"assistant\"\n ],\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"management_levels\": [\n \"c_suite\",\n \"vp\"\n ],\n \"departments\": [\n \"master_human_resources\"\n ],\n \"exclude_departments\": [\n \"master_human_resources\"\n ],\n \"department_functions\": [\n \"human_resources\"\n ],\n \"exclude_department_functions\": [\n \"software_development\"\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 \"exclude_people_locations\": [\n \"US\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"company_exclude_locations\": [\n \"CN\"\n ],\n \"company_linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"linkedin_urls\": [\n \"http://www.linkedin.com/in/king-lai-605382b7\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"company_filters\": {\n \"company_locations\": [\n \"US\"\n ],\n \"technologies\": [\n 37,\n 152\n ],\n \"founded_dates\": [\n 2015,\n 2023\n ],\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ]\n },\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ],\n \"is_enable_similarity_search\": true,\n \"similarity_score\": 0.7,\n \"per_page\": 25,\n \"page\": 1,\n \"query\": \"decision makers in marketing\",\n \"is_include_similar_people_titles\": true,\n \"people_title_similarity_score\": 0.9\n}"
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."
}Búsqueda
Búsqueda de personas
Busca en la base de datos de Pubrio personas que coincidan con criterios específicos como cargo, ubicación, empresa y antigüedad.
POST
/
people
/
search
Buscar personas
curl --request POST \
--url https://api.pubrio.com/people/search \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"search_term": "pubrio",
"people_name": "king",
"people_titles": [
"sales manager",
"marketing manager"
],
"exclude_people_titles": [
"intern",
"assistant"
],
"peoples": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"management_levels": [
"c_suite",
"vp"
],
"departments": [
"master_human_resources"
],
"exclude_departments": [
"master_human_resources"
],
"department_functions": [
"human_resources"
],
"exclude_department_functions": [
"software_development"
],
"employees": [
[
1,
10
],
[
11,
20
],
[
10001
]
],
"people_locations": [
"US",
"SG",
"CN"
],
"exclude_people_locations": [
"US"
],
"company_locations": [
"US",
"SG",
"CN"
],
"company_exclude_locations": [
"CN"
],
"company_linkedin_urls": [
"https://www.linkedin.com/company/pubrio"
],
"linkedin_urls": [
"http://www.linkedin.com/in/king-lai-605382b7"
],
"companies": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"domains": [
"pubrio.com"
],
"company_filters": {
"company_locations": [
"US"
],
"technologies": [
37,
152
],
"founded_dates": [
2015,
2023
],
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
]
},
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
],
"is_enable_similarity_search": true,
"similarity_score": 0.7,
"per_page": 25,
"page": 1,
"query": "decision makers in marketing",
"is_include_similar_people_titles": true,
"people_title_similarity_score": 0.9
}
'import requests
url = "https://api.pubrio.com/people/search"
payload = {
"search_term": "pubrio",
"people_name": "king",
"people_titles": ["sales manager", "marketing manager"],
"exclude_people_titles": ["intern", "assistant"],
"peoples": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"management_levels": ["c_suite", "vp"],
"departments": ["master_human_resources"],
"exclude_departments": ["master_human_resources"],
"department_functions": ["human_resources"],
"exclude_department_functions": ["software_development"],
"employees": [[1, 10], [11, 20], [10001]],
"people_locations": ["US", "SG", "CN"],
"exclude_people_locations": ["US"],
"company_locations": ["US", "SG", "CN"],
"company_exclude_locations": ["CN"],
"company_linkedin_urls": ["https://www.linkedin.com/company/pubrio"],
"linkedin_urls": ["http://www.linkedin.com/in/king-lai-605382b7"],
"companies": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"],
"domains": ["pubrio.com"],
"company_filters": {
"company_locations": ["US"],
"technologies": [37, 152],
"founded_dates": [2015, 2023],
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
]
},
"filter_conditions": [
{
"key": "technologies",
"operator": "and"
}
],
"is_enable_similarity_search": True,
"similarity_score": 0.7,
"per_page": 25,
"page": 1,
"query": "decision makers in marketing",
"is_include_similar_people_titles": True,
"people_title_similarity_score": 0.9
}
headers = {
"pubrio-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
search_term: 'pubrio',
people_name: 'king',
people_titles: ['sales manager', 'marketing manager'],
exclude_people_titles: ['intern', 'assistant'],
peoples: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
management_levels: ['c_suite', 'vp'],
departments: ['master_human_resources'],
exclude_departments: ['master_human_resources'],
department_functions: ['human_resources'],
exclude_department_functions: ['software_development'],
employees: [[1, 10], [11, 20], [10001]],
people_locations: ['US', 'SG', 'CN'],
exclude_people_locations: ['US'],
company_locations: ['US', 'SG', 'CN'],
company_exclude_locations: ['CN'],
company_linkedin_urls: ['https://www.linkedin.com/company/pubrio'],
linkedin_urls: ['http://www.linkedin.com/in/king-lai-605382b7'],
companies: ['3c90c3cc-0d44-4b50-8888-8dd25736052a'],
domains: ['pubrio.com'],
company_filters: {
company_locations: ['US'],
technologies: [37, 152],
founded_dates: [2015, 2023],
filter_conditions: [{key: 'technologies', operator: 'and'}]
},
filter_conditions: [{key: 'technologies', operator: 'and'}],
is_enable_similarity_search: true,
similarity_score: 0.7,
per_page: 25,
page: 1,
query: 'decision makers in marketing',
is_include_similar_people_titles: true,
people_title_similarity_score: 0.9
})
};
fetch('https://api.pubrio.com/people/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.pubrio.com/people/search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'search_term' => 'pubrio',
'people_name' => 'king',
'people_titles' => [
'sales manager',
'marketing manager'
],
'exclude_people_titles' => [
'intern',
'assistant'
],
'peoples' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'management_levels' => [
'c_suite',
'vp'
],
'departments' => [
'master_human_resources'
],
'exclude_departments' => [
'master_human_resources'
],
'department_functions' => [
'human_resources'
],
'exclude_department_functions' => [
'software_development'
],
'employees' => [
[
1,
10
],
[
11,
20
],
[
10001
]
],
'people_locations' => [
'US',
'SG',
'CN'
],
'exclude_people_locations' => [
'US'
],
'company_locations' => [
'US',
'SG',
'CN'
],
'company_exclude_locations' => [
'CN'
],
'company_linkedin_urls' => [
'https://www.linkedin.com/company/pubrio'
],
'linkedin_urls' => [
'http://www.linkedin.com/in/king-lai-605382b7'
],
'companies' => [
'3c90c3cc-0d44-4b50-8888-8dd25736052a'
],
'domains' => [
'pubrio.com'
],
'company_filters' => [
'company_locations' => [
'US'
],
'technologies' => [
37,
152
],
'founded_dates' => [
2015,
2023
],
'filter_conditions' => [
[
'key' => 'technologies',
'operator' => 'and'
]
]
],
'filter_conditions' => [
[
'key' => 'technologies',
'operator' => 'and'
]
],
'is_enable_similarity_search' => true,
'similarity_score' => 0.7,
'per_page' => 25,
'page' => 1,
'query' => 'decision makers in marketing',
'is_include_similar_people_titles' => true,
'people_title_similarity_score' => 0.9
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"pubrio-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.pubrio.com/people/search"
payload := strings.NewReader("{\n \"search_term\": \"pubrio\",\n \"people_name\": \"king\",\n \"people_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"exclude_people_titles\": [\n \"intern\",\n \"assistant\"\n ],\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"management_levels\": [\n \"c_suite\",\n \"vp\"\n ],\n \"departments\": [\n \"master_human_resources\"\n ],\n \"exclude_departments\": [\n \"master_human_resources\"\n ],\n \"department_functions\": [\n \"human_resources\"\n ],\n \"exclude_department_functions\": [\n \"software_development\"\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 \"exclude_people_locations\": [\n \"US\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"company_exclude_locations\": [\n \"CN\"\n ],\n \"company_linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"linkedin_urls\": [\n \"http://www.linkedin.com/in/king-lai-605382b7\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"company_filters\": {\n \"company_locations\": [\n \"US\"\n ],\n \"technologies\": [\n 37,\n 152\n ],\n \"founded_dates\": [\n 2015,\n 2023\n ],\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ]\n },\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ],\n \"is_enable_similarity_search\": true,\n \"similarity_score\": 0.7,\n \"per_page\": 25,\n \"page\": 1,\n \"query\": \"decision makers in marketing\",\n \"is_include_similar_people_titles\": true,\n \"people_title_similarity_score\": 0.9\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("pubrio-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.pubrio.com/people/search")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"search_term\": \"pubrio\",\n \"people_name\": \"king\",\n \"people_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"exclude_people_titles\": [\n \"intern\",\n \"assistant\"\n ],\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"management_levels\": [\n \"c_suite\",\n \"vp\"\n ],\n \"departments\": [\n \"master_human_resources\"\n ],\n \"exclude_departments\": [\n \"master_human_resources\"\n ],\n \"department_functions\": [\n \"human_resources\"\n ],\n \"exclude_department_functions\": [\n \"software_development\"\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 \"exclude_people_locations\": [\n \"US\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"company_exclude_locations\": [\n \"CN\"\n ],\n \"company_linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"linkedin_urls\": [\n \"http://www.linkedin.com/in/king-lai-605382b7\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"company_filters\": {\n \"company_locations\": [\n \"US\"\n ],\n \"technologies\": [\n 37,\n 152\n ],\n \"founded_dates\": [\n 2015,\n 2023\n ],\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ]\n },\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ],\n \"is_enable_similarity_search\": true,\n \"similarity_score\": 0.7,\n \"per_page\": 25,\n \"page\": 1,\n \"query\": \"decision makers in marketing\",\n \"is_include_similar_people_titles\": true,\n \"people_title_similarity_score\": 0.9\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/people/search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"search_term\": \"pubrio\",\n \"people_name\": \"king\",\n \"people_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"exclude_people_titles\": [\n \"intern\",\n \"assistant\"\n ],\n \"peoples\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"management_levels\": [\n \"c_suite\",\n \"vp\"\n ],\n \"departments\": [\n \"master_human_resources\"\n ],\n \"exclude_departments\": [\n \"master_human_resources\"\n ],\n \"department_functions\": [\n \"human_resources\"\n ],\n \"exclude_department_functions\": [\n \"software_development\"\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 \"exclude_people_locations\": [\n \"US\"\n ],\n \"company_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"company_exclude_locations\": [\n \"CN\"\n ],\n \"company_linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"linkedin_urls\": [\n \"http://www.linkedin.com/in/king-lai-605382b7\"\n ],\n \"companies\": [\n \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"company_filters\": {\n \"company_locations\": [\n \"US\"\n ],\n \"technologies\": [\n 37,\n 152\n ],\n \"founded_dates\": [\n 2015,\n 2023\n ],\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ]\n },\n \"filter_conditions\": [\n {\n \"key\": \"technologies\",\n \"operator\": \"and\"\n }\n ],\n \"is_enable_similarity_search\": true,\n \"similarity_score\": 0.7,\n \"per_page\": 25,\n \"page\": 1,\n \"query\": \"decision makers in marketing\",\n \"is_include_similar_people_titles\": true,\n \"people_title_similarity_score\": 0.9\n}"
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."
}Autorizaciones
Un token de API único que representa las acciones que realizas a través de la API, junto con los permisos y operaciones correspondientes. Puedes crearlo en la sección Configuración.
Cuerpo
application/json
Una cadena de palabras sobre la que queremos filtrar los resultados.
Ejemplo:
"pubrio"
Filtra los resultados de búsqueda para incluir un nombre de persona específico.
Ejemplo:
"king"
Cargos asociados a las personas que deseas localizar.
Los resultados también incluirán cargos que contengan terminología similar, aunque no coincidan exactamente. Por ejemplo, buscar software engineer puede devolver resultados de personas con el cargo senior software engineer.
Ejemplo:
["sales manager", "marketing manager"]
Cargos a excluir. Misma coincidencia a nivel de palabra que people_titles, por lo que ["senior"] elimina todos los cargos que contengan esa palabra. Se aplica después de people_titles.
Ejemplo:
["intern", "assistant"]
Una lista de identificadores únicos (people_search_id) utilizada para operaciones de búsqueda de personas.
Nivel jerárquico de la persona. El slug para la alta dirección es c_suite, no c_level. Los slugs desconocidos se descartan cuando hay otros filtros de personas presentes, y fallan con 40037 cuando este es el único filtro. Lista completa en el endpoint management level de la pestaña Filters.
Opciones disponibles:
c_suite, director, entry, founder, head, intern, manager, owner, partner, senior, vp Ejemplo:
["c_suite", "vp"]
El campo de departamento permite buscar personas en áreas de especialización específicas.
Consulta los endpoints department en la pestaña Filters para más información.
Ejemplo:
["master_human_resources"]
Slugs de departamento a excluir. Mismo vocabulario que departments. Se conservan las personas sin departamento registrado.
Ejemplo:
["master_human_resources"]
El campo de filtro para funciones laborales permite especificar roles o áreas de especialización concretas al buscar personas.
Consulta los endpoints department functions en la pestaña Filters para más información.
Ejemplo:
["human_resources"]
Slugs de función a excluir. Mismo vocabulario que department_functions. Se conservan las personas sin función registrada.
Ejemplo:
["software_development"]
El rango numérico de empleados que trabajan en la empresa. Esto te permite encontrar empresas según su plantilla. Puedes añadir varios rangos para ampliar los resultados de búsqueda.
Consulta los endpoints company size en la pestaña Filters para más información.
Ejemplo:
[[1, 10], [11, 20], [10001]]
La ubicación donde viven las personas. Consulta los endpoints location en la pestaña Filters para más información.
Ejemplo:
["US", "SG", "CN"]
Países en los que la persona no debe residir (ISO 3166-1 alfa-2). Complemento de people_locations.
Ejemplo:
["US"]
La ubicación de la sede de la empresa. Consulta los endpoints location en la pestaña Filters para más información.
Ejemplo:
["US", "SG", "CN"]
Países de sede a excluir (ISO 3166-1 alfa-2). Complemento de company_locations; enviar el mismo código en ambos no devuelve nada.
Ejemplo:
["CN"]
La URL completa del perfil de LinkedIn de la empresa. La URL debe empezar por http y contener linkedin.com/company/
Ejemplo:
["https://www.linkedin.com/company/pubrio"]
La URL completa del perfil de LinkedIn del usuario. La URL debe empezar por http y contener linkedin.com/in/ o linkedin.com/pub/
Ejemplo:
[
"http://www.linkedin.com/in/king-lai-605382b7"
]
Una lista de identificadores únicos (domain_search_id) utilizada para operaciones de búsqueda de empresas y personas.
Lista de dominios de empresa utilizada para operaciones de búsqueda de empresas y personas. Si recibimos una URL como www.pubrio.com o https://docs.pubrio.com/, el sistema la convertirá a pubrio.com para su procesamiento.
Ejemplo:
["pubrio.com"]
Objeto contenedor para filtros a nivel de empresa. Agrupación recomendada que separa visualmente qué claves filtran a la persona (nivel superior) de cuáles filtran a la empresa. Acepta las mismas claves que los filtros de empresa de nivel superior (por ejemplo, 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, además de filter_conditions). El motor aplana este objeto al nivel superior antes de procesarlo — las claves de nivel superior prevalecen en caso de conflicto. Misma estructura que usa company_filters en Monitor. Consulta la guía para desarrolladores sobre filtros para ver ejemplos.
Ejemplo:
{
"company_locations": ["US"],
"technologies": [37, 152],
"founded_dates": [2015, 2023],
"filter_conditions": [
{ "key": "technologies", "operator": "and" }
]
}
Anulación de AND/OR por clave para los filtros en /people/search. Por defecto es OR cuando se omite. Consulta la guía para desarrolladores de filtros de personas y empresas para la referencia completa de reasignación de claves.
Show child attributes
Show child attributes
Cuando está habilitado, los filtros indicados anteriormente que admiten búsquedas por similitud pueden completarse con texto libre en lugar de IDs específicos.
Se usa junto con is_enable_similarity_search. Este número se utiliza para analizar si un slug específico (por ejemplo, vertical de industria, tecnología) es similar a la entrada del usuario, y cuanto mayor es el número, más estricto es.
Ejemplo:
0.7
Registros por página. Por defecto es 25, que también es el límite en la mayoría de los planes — el límite es el max_search_per_page de tu suscripción, devuelto por Perfil. Superarlo devuelve HTTP 416 con el código 41676 (o 41613 en la búsqueda de empresas y personas), no un conjunto de resultados recortado.
Rango requerido:
x <= 25Ejemplo:
25
Búsqueda en lenguaje natural. Cuando se proporciona, Pubrio la interpreta en los filtros de persona y empresa que aparecen a continuación (rol, antigüedad, departamento, ubicación, industria, tamaño de empresa y más). Cualquier filtro explícito que también envíes tiene prioridad sobre los interpretados. Déjalo vacío para buscar únicamente por los filtros estructurados.
Ejemplo:
"decision makers in marketing"
Cuando está habilitado, people_titles también coincide con cargos estrechamente relacionados (por ejemplo, software engineer coincide con senior software engineer) en lugar de solo coincidencias exactas.
Se usa junto con is_include_similar_people_titles. Controla cuán cercana debe ser la coincidencia de un cargo; cuanto mayor es el número, más estricta es la coincidencia.
Ejemplo:
0.9
Respuesta
Respuesta exitosa que contiene los detalles de la búsqueda de personas.