Search for people
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,
"technologies": [
123
],
"categories": [
123
],
"verticals": [
123
],
"vertical_categories": [
123
],
"vertical_sub_categories": [
123
],
"keywords": [
"ecommerce",
"ai",
"fintech"
],
"founded_dates": [
2018,
2024
],
"revenues": [
0,
100000
],
"company_places": [
"Tokyo"
],
"company_exclude_places": [
"Tokyo"
]
}
'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,
"technologies": [123],
"categories": [123],
"verticals": [123],
"vertical_categories": [123],
"vertical_sub_categories": [123],
"keywords": ["ecommerce", "ai", "fintech"],
"founded_dates": [2018, 2024],
"revenues": [0, 100000],
"company_places": ["Tokyo"],
"company_exclude_places": ["Tokyo"]
}
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,
technologies: [123],
categories: [123],
verticals: [123],
vertical_categories: [123],
vertical_sub_categories: [123],
keywords: ['ecommerce', 'ai', 'fintech'],
founded_dates: [2018, 2024],
revenues: [0, 100000],
company_places: ['Tokyo'],
company_exclude_places: ['Tokyo']
})
};
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,
'technologies' => [
123
],
'categories' => [
123
],
'verticals' => [
123
],
'vertical_categories' => [
123
],
'vertical_sub_categories' => [
123
],
'keywords' => [
'ecommerce',
'ai',
'fintech'
],
'founded_dates' => [
2018,
2024
],
'revenues' => [
0,
100000
],
'company_places' => [
'Tokyo'
],
'company_exclude_places' => [
'Tokyo'
]
]),
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 \"technologies\": [\n 123\n ],\n \"categories\": [\n 123\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_categories\": [\n 123\n ],\n \"keywords\": [\n \"ecommerce\",\n \"ai\",\n \"fintech\"\n ],\n \"founded_dates\": [\n 2018,\n 2024\n ],\n \"revenues\": [\n 0,\n 100000\n ],\n \"company_places\": [\n \"Tokyo\"\n ],\n \"company_exclude_places\": [\n \"Tokyo\"\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")
.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 \"technologies\": [\n 123\n ],\n \"categories\": [\n 123\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_categories\": [\n 123\n ],\n \"keywords\": [\n \"ecommerce\",\n \"ai\",\n \"fintech\"\n ],\n \"founded_dates\": [\n 2018,\n 2024\n ],\n \"revenues\": [\n 0,\n 100000\n ],\n \"company_places\": [\n \"Tokyo\"\n ],\n \"company_exclude_places\": [\n \"Tokyo\"\n ]\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 \"technologies\": [\n 123\n ],\n \"categories\": [\n 123\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_categories\": [\n 123\n ],\n \"keywords\": [\n \"ecommerce\",\n \"ai\",\n \"fintech\"\n ],\n \"founded_dates\": [\n 2018,\n 2024\n ],\n \"revenues\": [\n 0,\n 100000\n ],\n \"company_places\": [\n \"Tokyo\"\n ],\n \"company_exclude_places\": [\n \"Tokyo\"\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."
}Search
People Search
Search the Pubrio database for people matching specified criteria such as job title, location, company, and seniority.
POST
/
people
/
search
Search for people
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,
"technologies": [
123
],
"categories": [
123
],
"verticals": [
123
],
"vertical_categories": [
123
],
"vertical_sub_categories": [
123
],
"keywords": [
"ecommerce",
"ai",
"fintech"
],
"founded_dates": [
2018,
2024
],
"revenues": [
0,
100000
],
"company_places": [
"Tokyo"
],
"company_exclude_places": [
"Tokyo"
]
}
'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,
"technologies": [123],
"categories": [123],
"verticals": [123],
"vertical_categories": [123],
"vertical_sub_categories": [123],
"keywords": ["ecommerce", "ai", "fintech"],
"founded_dates": [2018, 2024],
"revenues": [0, 100000],
"company_places": ["Tokyo"],
"company_exclude_places": ["Tokyo"]
}
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,
technologies: [123],
categories: [123],
verticals: [123],
vertical_categories: [123],
vertical_sub_categories: [123],
keywords: ['ecommerce', 'ai', 'fintech'],
founded_dates: [2018, 2024],
revenues: [0, 100000],
company_places: ['Tokyo'],
company_exclude_places: ['Tokyo']
})
};
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,
'technologies' => [
123
],
'categories' => [
123
],
'verticals' => [
123
],
'vertical_categories' => [
123
],
'vertical_sub_categories' => [
123
],
'keywords' => [
'ecommerce',
'ai',
'fintech'
],
'founded_dates' => [
2018,
2024
],
'revenues' => [
0,
100000
],
'company_places' => [
'Tokyo'
],
'company_exclude_places' => [
'Tokyo'
]
]),
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 \"technologies\": [\n 123\n ],\n \"categories\": [\n 123\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_categories\": [\n 123\n ],\n \"keywords\": [\n \"ecommerce\",\n \"ai\",\n \"fintech\"\n ],\n \"founded_dates\": [\n 2018,\n 2024\n ],\n \"revenues\": [\n 0,\n 100000\n ],\n \"company_places\": [\n \"Tokyo\"\n ],\n \"company_exclude_places\": [\n \"Tokyo\"\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")
.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 \"technologies\": [\n 123\n ],\n \"categories\": [\n 123\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_categories\": [\n 123\n ],\n \"keywords\": [\n \"ecommerce\",\n \"ai\",\n \"fintech\"\n ],\n \"founded_dates\": [\n 2018,\n 2024\n ],\n \"revenues\": [\n 0,\n 100000\n ],\n \"company_places\": [\n \"Tokyo\"\n ],\n \"company_exclude_places\": [\n \"Tokyo\"\n ]\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 \"technologies\": [\n 123\n ],\n \"categories\": [\n 123\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_categories\": [\n 123\n ],\n \"keywords\": [\n \"ecommerce\",\n \"ai\",\n \"fintech\"\n ],\n \"founded_dates\": [\n 2018,\n 2024\n ],\n \"revenues\": [\n 0,\n 100000\n ],\n \"company_places\": [\n \"Tokyo\"\n ],\n \"company_exclude_places\": [\n \"Tokyo\"\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."
}Authorizations
Body
application/json
A string of words over which we want to filter the results.
Example:
"pubrio"
Filter search results to include a specific people name.
Example:
"king"
Job titles associated with the individuals you aim to locate.
The results will also encompass job titles that include similar terminology, even if they do not match exactly. For instance, searching for software engineer may yield results for individuals with the title senior software engineer.
Example:
["sales manager", "marketing manager"]
Job titles to leave out. Same word-level matching as people_titles, so ["senior"] removes every title containing that word. Applied after people_titles.
Example:
["intern", "assistant"]
A list of unique identifiers (people_search_id) used for people search operations.
Reporting tier of the person. The C-suite slug is c_suite, not c_level. An unknown slug matches nobody. Full list from the management level endpoint under Filters.
Available options:
c_suite, director, entry, founder, head, intern, manager, owner, partner, senior, vp Example:
["c_suite", "vp"]
The department field can search for people in specific areas of expertise.
Check out department endpoints under the Filters tab for more information.
Example:
["master_human_resources"]
Department slugs to leave out. Same vocabulary as departments. People with no department recorded are kept.
Example:
["master_human_resources"]
The filter field for job functions can specify particular roles or areas of expertise when searching for people.
Check out department functions endpoints under the Filters tab for more information.
Example:
["human_resources"]
Function slugs to leave out. Same vocabulary as department_functions. People with no function recorded are kept.
Example:
["software_development"]
The number range of employees working for the company. This enables you to find companies based on headcount. You can add multiple ranges to expand your search results.
Check out company size endpoints under the Filters tab for more information.
Example:
[[1, 10], [11, 20], [10001]]
The location where people live. Check out location endpoints under the Filters tab for more information.
Example:
["US", "SG", "CN"]
Countries the person must not live in (ISO 3166-1 alpha-2). Companion of people_locations.
Example:
["US"]
The location of the company headquarters. Check out location endpoints under the Filters tab for more information.
Example:
["US", "SG", "CN"]
Headquarters countries to leave out (ISO 3166-1 alpha-2). Companion of company_locations; sending the same code in both returns nothing.
Example:
["CN"]
The fully formed URL of the LinkedIn company profile. URL begin with http and contain linkedin.com/company/
Example:
["https://www.linkedin.com/company/pubrio"]
The fully formed URL of the LinkedIn user profile. URL begin with http and contain linkedin.com/in/ or linkedin.com/pub/
Example:
[
"http://www.linkedin.com/in/king-lai-605382b7"
]
A list of unique identifiers (domain_search_id) used for company and people search operations.
List of company domains used for company and people search operations. If we receive a URL such as www.pubrio.com or https://docs.pubrio.com/, the system will convert it to pubrio.com for processing.
Example:
["pubrio.com"]
Wrapper object for company-level filters. Recommended grouping that visually separates which keys filter the person (top-level) from which filter the company. Accepts the same keys as the top-level company filters (e.g. 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, plus filter_conditions). Engine flattens this object to the top level before processing — top-level keys win on conflict. Same shape used by Monitor company_filters. See the Filters Overview developer guide for examples.
Example:
{
"company_locations": ["US"],
"technologies": [37, 152],
"founded_dates": [2015, 2023],
"filter_conditions": [
{ "key": "technologies", "operator": "and" }
]
}
Per-key AND/OR override for filters in /people/search. Defaults to OR when omitted. See the People + Company Filters developer guide for the full key-remap reference.
Show child attributes
Show child attributes
When enabled, the filters listed above that support similarity searches can be filled with free text for specific IDs.
It is used in conjunction with is_enable_similarity_search. This number is used to analyze whether a specific slug (e.g. vertical industry, technology) is similar to the user input, and the higher the number, the more stringent it is.
Example:
0.7
Records per page. Defaults to 25, which is also the ceiling on most plans — the limit is your subscription's max_search_per_page, returned by Profile. Exceeding it returns HTTP 416 with code 41676 (or 41613 on company and people search), not a clamped result set.
Required range:
x <= 25Example:
25
Natural-language search. When provided, Pubrio interprets it into the person and company filters below (job role, seniority, department, location, industry, company size, and more). Any explicit filters you also pass take precedence over the interpreted ones. Leave empty to search purely by the structured filters.
Example:
"decision makers in marketing"
Enabled by default. people_titles also matches close variants of each title (for example, software engineer matches senior software engineer). metadata.filters.people_titles returns the full list that was searched.
Used together with is_include_similar_people_titles. Controls how closely a title must match; the higher the number, the stricter the match.
Example:
0.9
A list of tag_id used to search for specific technologies used by companies. To find the ID, call the technology endpoint under the Filters tab.
This filter supports is_enable_similarity_search, once enabled you can enter any free text, e.g. ["Shopify"].
A product name the technology list knows matches that product and its own products ("Salesforce" also matches Salesforce Desk and Salesforce Service Cloud), never look-alikes; other text matches by similarity.
A list of category_id used to search for specific categories of technology used by companies. To find the ID, call the category endpoint under the Filters tab.
This filter supports is_enable_similarity_search, once enabled you can enter any free text, e.g. ["CDN"].
A list of vertical_id used to search for companies in a specific vertical or industry. To find the ID, call the vertical endpoint under the Filters tab.
This filter supports is_enable_similarity_search, once enabled you can enter any free text, e.g. ["AI"].
A list of vertical_category_id used to search for companies in a specific vertical category. To find the ID, call the vertical category endpoint under the Filters tab.
This filter supports is_enable_similarity_search, once enabled you can enter any free text, e.g. ["Information Technology"].
A list of vertical_sub_category_id used to search for companies in a specific vertical sub-category. To find the ID, call the vertical sub category endpoint under the Filters tab.
This filter supports is_enable_similarity_search, once enabled you can enter any free text, e.g. ["Software"].
A list of keywords to filter companies by relevance, specialties, or descriptions.
Example:
["ecommerce", "ai", "fintech"]
Years of company founded range. The maximum value founded is the current year.
Example:
[2018, 2024]
Minimum and maximum range of company revenue.
Example:
[0, 100000]
Place names (city, region) used to filter results. Accepts localized or English place names.
Example:
["Tokyo"]
Place names (city, region) to exclude from results. Accepts localized or English place names.
Example:
["Tokyo"]
Last modified on November 12, 2024