확장 검색
curl --request POST \
--url https://api.pubrio.com/expansions/search \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"froms": [
"US",
"GB"
],
"tos": [
"US",
"GB"
],
"exclude_froms": [
"US",
"GB"
],
"exclude_tos": [
"US",
"GB"
],
"stages": [
"committing",
"expanding"
],
"momentum": [
"advancing",
"steady"
],
"freshness": [
"fresh",
"cooling"
],
"scopes": [
"entering_new_market"
],
"ahead_of_pace": false,
"signal_types": [
"EXEC",
"HIRE"
],
"signal_strengths": [
"high"
],
"min_signal_count": 3,
"only_contraction": false,
"min_markets": 3,
"home_country_code": [
"SG"
],
"industries": [
"software",
"financial services"
],
"exclude_industries": [
"tobacco"
],
"verticals": [
123
],
"vertical_categories": [
123
],
"vertical_sub_categories": [
123
],
"technologies": [
123
],
"employees": [
[
1,
10
],
[
11,
20
],
[
10001
]
],
"revenues": [
0,
100000
],
"founded_dates": [
2018,
2024
],
"keywords": [
"ecommerce",
"ai",
"fintech"
],
"companies": [
"stripe.com",
"https://www.linkedin.com/company/airbnb",
"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"
],
"job_locations": [
"US",
"SG",
"CN"
],
"job_exclude_locations": [
"CN",
"US",
"RU",
"CA"
],
"job_posted_dates": [
"2025-01-01",
"2025-01-10"
],
"job_titles": [
"sales manager",
"marketing manager"
],
"advertisement_target_locations": [
"TW",
"AE",
"NO"
],
"advertisement_exclude_target_locations": [
"IS",
"GB",
"FR",
"IE",
"ES"
],
"advertisement_search_terms": [
"asus"
],
"advertisement_start_dates": [
"2025-12-25",
"2025-12-25"
],
"advertisement_end_dates": [
"2025-12-25",
"2025-12-25"
],
"news_categories": [
"launches"
],
"news_published_dates": [
"2025-01-01",
"2025-01-10"
],
"transitioned_dates": [
"2026-04-01",
"2026-06-29"
],
"window_days": 90,
"query": "fintech companies expanding into the UK",
"is_explain_match": true,
"sort_by": "expansion_score",
"is_include_metadata": true,
"page": 1,
"per_page": 25,
"is_enable_similarity_search": true,
"filter_conditions": [
{
"key": "keywords",
"operator": "or"
}
]
}
'import requests
url = "https://api.pubrio.com/expansions/search"
payload = {
"froms": ["US", "GB"],
"tos": ["US", "GB"],
"exclude_froms": ["US", "GB"],
"exclude_tos": ["US", "GB"],
"stages": ["committing", "expanding"],
"momentum": ["advancing", "steady"],
"freshness": ["fresh", "cooling"],
"scopes": ["entering_new_market"],
"ahead_of_pace": False,
"signal_types": ["EXEC", "HIRE"],
"signal_strengths": ["high"],
"min_signal_count": 3,
"only_contraction": False,
"min_markets": 3,
"home_country_code": ["SG"],
"industries": ["software", "financial services"],
"exclude_industries": ["tobacco"],
"verticals": [123],
"vertical_categories": [123],
"vertical_sub_categories": [123],
"technologies": [123],
"employees": [[1, 10], [11, 20], [10001]],
"revenues": [0, 100000],
"founded_dates": [2018, 2024],
"keywords": ["ecommerce", "ai", "fintech"],
"companies": ["stripe.com", "https://www.linkedin.com/company/airbnb", "b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"],
"job_locations": ["US", "SG", "CN"],
"job_exclude_locations": ["CN", "US", "RU", "CA"],
"job_posted_dates": ["2025-01-01", "2025-01-10"],
"job_titles": ["sales manager", "marketing manager"],
"advertisement_target_locations": ["TW", "AE", "NO"],
"advertisement_exclude_target_locations": ["IS", "GB", "FR", "IE", "ES"],
"advertisement_search_terms": ["asus"],
"advertisement_start_dates": ["2025-12-25", "2025-12-25"],
"advertisement_end_dates": ["2025-12-25", "2025-12-25"],
"news_categories": ["launches"],
"news_published_dates": ["2025-01-01", "2025-01-10"],
"transitioned_dates": ["2026-04-01", "2026-06-29"],
"window_days": 90,
"query": "fintech companies expanding into the UK",
"is_explain_match": True,
"sort_by": "expansion_score",
"is_include_metadata": True,
"page": 1,
"per_page": 25,
"is_enable_similarity_search": True,
"filter_conditions": [
{
"key": "keywords",
"operator": "or"
}
]
}
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({
froms: ['US', 'GB'],
tos: ['US', 'GB'],
exclude_froms: ['US', 'GB'],
exclude_tos: ['US', 'GB'],
stages: ['committing', 'expanding'],
momentum: ['advancing', 'steady'],
freshness: ['fresh', 'cooling'],
scopes: ['entering_new_market'],
ahead_of_pace: false,
signal_types: ['EXEC', 'HIRE'],
signal_strengths: ['high'],
min_signal_count: 3,
only_contraction: false,
min_markets: 3,
home_country_code: ['SG'],
industries: ['software', 'financial services'],
exclude_industries: ['tobacco'],
verticals: [123],
vertical_categories: [123],
vertical_sub_categories: [123],
technologies: [123],
employees: [[1, 10], [11, 20], [10001]],
revenues: [0, 100000],
founded_dates: [2018, 2024],
keywords: ['ecommerce', 'ai', 'fintech'],
companies: [
'stripe.com',
'https://www.linkedin.com/company/airbnb',
'b7d92a56-31f8-4c0b-ae43-19c8e5f24b70'
],
job_locations: ['US', 'SG', 'CN'],
job_exclude_locations: ['CN', 'US', 'RU', 'CA'],
job_posted_dates: ['2025-01-01', '2025-01-10'],
job_titles: ['sales manager', 'marketing manager'],
advertisement_target_locations: ['TW', 'AE', 'NO'],
advertisement_exclude_target_locations: ['IS', 'GB', 'FR', 'IE', 'ES'],
advertisement_search_terms: ['asus'],
advertisement_start_dates: ['2025-12-25', '2025-12-25'],
advertisement_end_dates: ['2025-12-25', '2025-12-25'],
news_categories: ['launches'],
news_published_dates: ['2025-01-01', '2025-01-10'],
transitioned_dates: ['2026-04-01', '2026-06-29'],
window_days: 90,
query: 'fintech companies expanding into the UK',
is_explain_match: true,
sort_by: 'expansion_score',
is_include_metadata: true,
page: 1,
per_page: 25,
is_enable_similarity_search: true,
filter_conditions: [{key: 'keywords', operator: 'or'}]
})
};
fetch('https://api.pubrio.com/expansions/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/expansions/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([
'froms' => [
'US',
'GB'
],
'tos' => [
'US',
'GB'
],
'exclude_froms' => [
'US',
'GB'
],
'exclude_tos' => [
'US',
'GB'
],
'stages' => [
'committing',
'expanding'
],
'momentum' => [
'advancing',
'steady'
],
'freshness' => [
'fresh',
'cooling'
],
'scopes' => [
'entering_new_market'
],
'ahead_of_pace' => false,
'signal_types' => [
'EXEC',
'HIRE'
],
'signal_strengths' => [
'high'
],
'min_signal_count' => 3,
'only_contraction' => false,
'min_markets' => 3,
'home_country_code' => [
'SG'
],
'industries' => [
'software',
'financial services'
],
'exclude_industries' => [
'tobacco'
],
'verticals' => [
123
],
'vertical_categories' => [
123
],
'vertical_sub_categories' => [
123
],
'technologies' => [
123
],
'employees' => [
[
1,
10
],
[
11,
20
],
[
10001
]
],
'revenues' => [
0,
100000
],
'founded_dates' => [
2018,
2024
],
'keywords' => [
'ecommerce',
'ai',
'fintech'
],
'companies' => [
'stripe.com',
'https://www.linkedin.com/company/airbnb',
'b7d92a56-31f8-4c0b-ae43-19c8e5f24b70'
],
'job_locations' => [
'US',
'SG',
'CN'
],
'job_exclude_locations' => [
'CN',
'US',
'RU',
'CA'
],
'job_posted_dates' => [
'2025-01-01',
'2025-01-10'
],
'job_titles' => [
'sales manager',
'marketing manager'
],
'advertisement_target_locations' => [
'TW',
'AE',
'NO'
],
'advertisement_exclude_target_locations' => [
'IS',
'GB',
'FR',
'IE',
'ES'
],
'advertisement_search_terms' => [
'asus'
],
'advertisement_start_dates' => [
'2025-12-25',
'2025-12-25'
],
'advertisement_end_dates' => [
'2025-12-25',
'2025-12-25'
],
'news_categories' => [
'launches'
],
'news_published_dates' => [
'2025-01-01',
'2025-01-10'
],
'transitioned_dates' => [
'2026-04-01',
'2026-06-29'
],
'window_days' => 90,
'query' => 'fintech companies expanding into the UK',
'is_explain_match' => true,
'sort_by' => 'expansion_score',
'is_include_metadata' => true,
'page' => 1,
'per_page' => 25,
'is_enable_similarity_search' => true,
'filter_conditions' => [
[
'key' => 'keywords',
'operator' => 'or'
]
]
]),
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/expansions/search"
payload := strings.NewReader("{\n \"froms\": [\n \"US\",\n \"GB\"\n ],\n \"tos\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_froms\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_tos\": [\n \"US\",\n \"GB\"\n ],\n \"stages\": [\n \"committing\",\n \"expanding\"\n ],\n \"momentum\": [\n \"advancing\",\n \"steady\"\n ],\n \"freshness\": [\n \"fresh\",\n \"cooling\"\n ],\n \"scopes\": [\n \"entering_new_market\"\n ],\n \"ahead_of_pace\": false,\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"min_markets\": 3,\n \"home_country_code\": [\n \"SG\"\n ],\n \"industries\": [\n \"software\",\n \"financial services\"\n ],\n \"exclude_industries\": [\n \"tobacco\"\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_categories\": [\n 123\n ],\n \"technologies\": [\n 123\n ],\n \"employees\": [\n [\n 1,\n 10\n ],\n [\n 11,\n 20\n ],\n [\n 10001\n ]\n ],\n \"revenues\": [\n 0,\n 100000\n ],\n \"founded_dates\": [\n 2018,\n 2024\n ],\n \"keywords\": [\n \"ecommerce\",\n \"ai\",\n \"fintech\"\n ],\n \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\n ],\n \"job_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"job_exclude_locations\": [\n \"CN\",\n \"US\",\n \"RU\",\n \"CA\"\n ],\n \"job_posted_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"job_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"advertisement_target_locations\": [\n \"TW\",\n \"AE\",\n \"NO\"\n ],\n \"advertisement_exclude_target_locations\": [\n \"IS\",\n \"GB\",\n \"FR\",\n \"IE\",\n \"ES\"\n ],\n \"advertisement_search_terms\": [\n \"asus\"\n ],\n \"advertisement_start_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"advertisement_end_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"news_categories\": [\n \"launches\"\n ],\n \"news_published_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"fintech companies expanding into the UK\",\n \"is_explain_match\": true,\n \"sort_by\": \"expansion_score\",\n \"is_include_metadata\": true,\n \"page\": 1,\n \"per_page\": 25,\n \"is_enable_similarity_search\": true,\n \"filter_conditions\": [\n {\n \"key\": \"keywords\",\n \"operator\": \"or\"\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/expansions/search")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"froms\": [\n \"US\",\n \"GB\"\n ],\n \"tos\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_froms\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_tos\": [\n \"US\",\n \"GB\"\n ],\n \"stages\": [\n \"committing\",\n \"expanding\"\n ],\n \"momentum\": [\n \"advancing\",\n \"steady\"\n ],\n \"freshness\": [\n \"fresh\",\n \"cooling\"\n ],\n \"scopes\": [\n \"entering_new_market\"\n ],\n \"ahead_of_pace\": false,\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"min_markets\": 3,\n \"home_country_code\": [\n \"SG\"\n ],\n \"industries\": [\n \"software\",\n \"financial services\"\n ],\n \"exclude_industries\": [\n \"tobacco\"\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_categories\": [\n 123\n ],\n \"technologies\": [\n 123\n ],\n \"employees\": [\n [\n 1,\n 10\n ],\n [\n 11,\n 20\n ],\n [\n 10001\n ]\n ],\n \"revenues\": [\n 0,\n 100000\n ],\n \"founded_dates\": [\n 2018,\n 2024\n ],\n \"keywords\": [\n \"ecommerce\",\n \"ai\",\n \"fintech\"\n ],\n \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\n ],\n \"job_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"job_exclude_locations\": [\n \"CN\",\n \"US\",\n \"RU\",\n \"CA\"\n ],\n \"job_posted_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"job_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"advertisement_target_locations\": [\n \"TW\",\n \"AE\",\n \"NO\"\n ],\n \"advertisement_exclude_target_locations\": [\n \"IS\",\n \"GB\",\n \"FR\",\n \"IE\",\n \"ES\"\n ],\n \"advertisement_search_terms\": [\n \"asus\"\n ],\n \"advertisement_start_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"advertisement_end_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"news_categories\": [\n \"launches\"\n ],\n \"news_published_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"fintech companies expanding into the UK\",\n \"is_explain_match\": true,\n \"sort_by\": \"expansion_score\",\n \"is_include_metadata\": true,\n \"page\": 1,\n \"per_page\": 25,\n \"is_enable_similarity_search\": true,\n \"filter_conditions\": [\n {\n \"key\": \"keywords\",\n \"operator\": \"or\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/expansions/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 \"froms\": [\n \"US\",\n \"GB\"\n ],\n \"tos\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_froms\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_tos\": [\n \"US\",\n \"GB\"\n ],\n \"stages\": [\n \"committing\",\n \"expanding\"\n ],\n \"momentum\": [\n \"advancing\",\n \"steady\"\n ],\n \"freshness\": [\n \"fresh\",\n \"cooling\"\n ],\n \"scopes\": [\n \"entering_new_market\"\n ],\n \"ahead_of_pace\": false,\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"min_markets\": 3,\n \"home_country_code\": [\n \"SG\"\n ],\n \"industries\": [\n \"software\",\n \"financial services\"\n ],\n \"exclude_industries\": [\n \"tobacco\"\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_categories\": [\n 123\n ],\n \"technologies\": [\n 123\n ],\n \"employees\": [\n [\n 1,\n 10\n ],\n [\n 11,\n 20\n ],\n [\n 10001\n ]\n ],\n \"revenues\": [\n 0,\n 100000\n ],\n \"founded_dates\": [\n 2018,\n 2024\n ],\n \"keywords\": [\n \"ecommerce\",\n \"ai\",\n \"fintech\"\n ],\n \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\n ],\n \"job_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"job_exclude_locations\": [\n \"CN\",\n \"US\",\n \"RU\",\n \"CA\"\n ],\n \"job_posted_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"job_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"advertisement_target_locations\": [\n \"TW\",\n \"AE\",\n \"NO\"\n ],\n \"advertisement_exclude_target_locations\": [\n \"IS\",\n \"GB\",\n \"FR\",\n \"IE\",\n \"ES\"\n ],\n \"advertisement_search_terms\": [\n \"asus\"\n ],\n \"advertisement_start_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"advertisement_end_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"news_categories\": [\n \"launches\"\n ],\n \"news_published_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"fintech companies expanding into the UK\",\n \"is_explain_match\": true,\n \"sort_by\": \"expansion_score\",\n \"is_include_metadata\": true,\n \"page\": 1,\n \"per_page\": 25,\n \"is_enable_similarity_search\": true,\n \"filter_conditions\": [\n {\n \"key\": \"keywords\",\n \"operator\": \"or\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"metadata": {
"filters": {
"tos": [
"GB"
],
"verticals": [
"Financial Services"
]
}
},
"data": {
"pagination": {
"page": 1,
"per_page": 25,
"total_entries": 87,
"total_pages": 4,
"total_display_pages": 4,
"is_timeout": false
},
"companies": [
{
"expansion_id": "6845525",
"domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
"country_code": "GB",
"target_country_code": "GB",
"domain": "example.com",
"company_name": "Example Corp",
"home_country_code": "CN",
"industry": "Consumer Electronics",
"founded_year": 2015,
"employees_count": 320,
"stage": {
"slug": "expanding",
"expansion_score": 0.72,
"scope": "entering_new_market",
"direction": "advancing",
"freshness": "fresh",
"signal_count": 27,
"distinct_type_count": 3,
"last_transition_at": "2026-06-27T14:32:10.000Z"
},
"presence": {
"level": "established",
"local_people_count": 12,
"matched_rule": "headcount",
"has_known_office": true,
"established_min": 10,
"share_of_detected": 0.54
},
"read": {
"code": "establishing"
}
}
]
}
}{
"code": 40001,
"message": "오류 코드 및 메시지는 상황에 따라 다를 수 있습니다. 자세한 내용은 문서를 참조하세요.",
"details": {}
}{
"error": "요청 빈도가 제한을 초과했습니다. 잠시 후 다시 시도해주세요."
}{
"error": "요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다"
}확장
확장 검색
하나 이상의 시장으로 확장 중인 회사를 기업·신호 필터 또는 자연어 쿼리로 검색하며, 각 회사의 실제 신호에 기반한 AI 매칭 설명을 선택적으로 생성합니다. tos, froms, companies, query 중 하나 이상을 보내세요.
POST
/
expansions
/
search
확장 검색
curl --request POST \
--url https://api.pubrio.com/expansions/search \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"froms": [
"US",
"GB"
],
"tos": [
"US",
"GB"
],
"exclude_froms": [
"US",
"GB"
],
"exclude_tos": [
"US",
"GB"
],
"stages": [
"committing",
"expanding"
],
"momentum": [
"advancing",
"steady"
],
"freshness": [
"fresh",
"cooling"
],
"scopes": [
"entering_new_market"
],
"ahead_of_pace": false,
"signal_types": [
"EXEC",
"HIRE"
],
"signal_strengths": [
"high"
],
"min_signal_count": 3,
"only_contraction": false,
"min_markets": 3,
"home_country_code": [
"SG"
],
"industries": [
"software",
"financial services"
],
"exclude_industries": [
"tobacco"
],
"verticals": [
123
],
"vertical_categories": [
123
],
"vertical_sub_categories": [
123
],
"technologies": [
123
],
"employees": [
[
1,
10
],
[
11,
20
],
[
10001
]
],
"revenues": [
0,
100000
],
"founded_dates": [
2018,
2024
],
"keywords": [
"ecommerce",
"ai",
"fintech"
],
"companies": [
"stripe.com",
"https://www.linkedin.com/company/airbnb",
"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"
],
"job_locations": [
"US",
"SG",
"CN"
],
"job_exclude_locations": [
"CN",
"US",
"RU",
"CA"
],
"job_posted_dates": [
"2025-01-01",
"2025-01-10"
],
"job_titles": [
"sales manager",
"marketing manager"
],
"advertisement_target_locations": [
"TW",
"AE",
"NO"
],
"advertisement_exclude_target_locations": [
"IS",
"GB",
"FR",
"IE",
"ES"
],
"advertisement_search_terms": [
"asus"
],
"advertisement_start_dates": [
"2025-12-25",
"2025-12-25"
],
"advertisement_end_dates": [
"2025-12-25",
"2025-12-25"
],
"news_categories": [
"launches"
],
"news_published_dates": [
"2025-01-01",
"2025-01-10"
],
"transitioned_dates": [
"2026-04-01",
"2026-06-29"
],
"window_days": 90,
"query": "fintech companies expanding into the UK",
"is_explain_match": true,
"sort_by": "expansion_score",
"is_include_metadata": true,
"page": 1,
"per_page": 25,
"is_enable_similarity_search": true,
"filter_conditions": [
{
"key": "keywords",
"operator": "or"
}
]
}
'import requests
url = "https://api.pubrio.com/expansions/search"
payload = {
"froms": ["US", "GB"],
"tos": ["US", "GB"],
"exclude_froms": ["US", "GB"],
"exclude_tos": ["US", "GB"],
"stages": ["committing", "expanding"],
"momentum": ["advancing", "steady"],
"freshness": ["fresh", "cooling"],
"scopes": ["entering_new_market"],
"ahead_of_pace": False,
"signal_types": ["EXEC", "HIRE"],
"signal_strengths": ["high"],
"min_signal_count": 3,
"only_contraction": False,
"min_markets": 3,
"home_country_code": ["SG"],
"industries": ["software", "financial services"],
"exclude_industries": ["tobacco"],
"verticals": [123],
"vertical_categories": [123],
"vertical_sub_categories": [123],
"technologies": [123],
"employees": [[1, 10], [11, 20], [10001]],
"revenues": [0, 100000],
"founded_dates": [2018, 2024],
"keywords": ["ecommerce", "ai", "fintech"],
"companies": ["stripe.com", "https://www.linkedin.com/company/airbnb", "b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"],
"job_locations": ["US", "SG", "CN"],
"job_exclude_locations": ["CN", "US", "RU", "CA"],
"job_posted_dates": ["2025-01-01", "2025-01-10"],
"job_titles": ["sales manager", "marketing manager"],
"advertisement_target_locations": ["TW", "AE", "NO"],
"advertisement_exclude_target_locations": ["IS", "GB", "FR", "IE", "ES"],
"advertisement_search_terms": ["asus"],
"advertisement_start_dates": ["2025-12-25", "2025-12-25"],
"advertisement_end_dates": ["2025-12-25", "2025-12-25"],
"news_categories": ["launches"],
"news_published_dates": ["2025-01-01", "2025-01-10"],
"transitioned_dates": ["2026-04-01", "2026-06-29"],
"window_days": 90,
"query": "fintech companies expanding into the UK",
"is_explain_match": True,
"sort_by": "expansion_score",
"is_include_metadata": True,
"page": 1,
"per_page": 25,
"is_enable_similarity_search": True,
"filter_conditions": [
{
"key": "keywords",
"operator": "or"
}
]
}
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({
froms: ['US', 'GB'],
tos: ['US', 'GB'],
exclude_froms: ['US', 'GB'],
exclude_tos: ['US', 'GB'],
stages: ['committing', 'expanding'],
momentum: ['advancing', 'steady'],
freshness: ['fresh', 'cooling'],
scopes: ['entering_new_market'],
ahead_of_pace: false,
signal_types: ['EXEC', 'HIRE'],
signal_strengths: ['high'],
min_signal_count: 3,
only_contraction: false,
min_markets: 3,
home_country_code: ['SG'],
industries: ['software', 'financial services'],
exclude_industries: ['tobacco'],
verticals: [123],
vertical_categories: [123],
vertical_sub_categories: [123],
technologies: [123],
employees: [[1, 10], [11, 20], [10001]],
revenues: [0, 100000],
founded_dates: [2018, 2024],
keywords: ['ecommerce', 'ai', 'fintech'],
companies: [
'stripe.com',
'https://www.linkedin.com/company/airbnb',
'b7d92a56-31f8-4c0b-ae43-19c8e5f24b70'
],
job_locations: ['US', 'SG', 'CN'],
job_exclude_locations: ['CN', 'US', 'RU', 'CA'],
job_posted_dates: ['2025-01-01', '2025-01-10'],
job_titles: ['sales manager', 'marketing manager'],
advertisement_target_locations: ['TW', 'AE', 'NO'],
advertisement_exclude_target_locations: ['IS', 'GB', 'FR', 'IE', 'ES'],
advertisement_search_terms: ['asus'],
advertisement_start_dates: ['2025-12-25', '2025-12-25'],
advertisement_end_dates: ['2025-12-25', '2025-12-25'],
news_categories: ['launches'],
news_published_dates: ['2025-01-01', '2025-01-10'],
transitioned_dates: ['2026-04-01', '2026-06-29'],
window_days: 90,
query: 'fintech companies expanding into the UK',
is_explain_match: true,
sort_by: 'expansion_score',
is_include_metadata: true,
page: 1,
per_page: 25,
is_enable_similarity_search: true,
filter_conditions: [{key: 'keywords', operator: 'or'}]
})
};
fetch('https://api.pubrio.com/expansions/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/expansions/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([
'froms' => [
'US',
'GB'
],
'tos' => [
'US',
'GB'
],
'exclude_froms' => [
'US',
'GB'
],
'exclude_tos' => [
'US',
'GB'
],
'stages' => [
'committing',
'expanding'
],
'momentum' => [
'advancing',
'steady'
],
'freshness' => [
'fresh',
'cooling'
],
'scopes' => [
'entering_new_market'
],
'ahead_of_pace' => false,
'signal_types' => [
'EXEC',
'HIRE'
],
'signal_strengths' => [
'high'
],
'min_signal_count' => 3,
'only_contraction' => false,
'min_markets' => 3,
'home_country_code' => [
'SG'
],
'industries' => [
'software',
'financial services'
],
'exclude_industries' => [
'tobacco'
],
'verticals' => [
123
],
'vertical_categories' => [
123
],
'vertical_sub_categories' => [
123
],
'technologies' => [
123
],
'employees' => [
[
1,
10
],
[
11,
20
],
[
10001
]
],
'revenues' => [
0,
100000
],
'founded_dates' => [
2018,
2024
],
'keywords' => [
'ecommerce',
'ai',
'fintech'
],
'companies' => [
'stripe.com',
'https://www.linkedin.com/company/airbnb',
'b7d92a56-31f8-4c0b-ae43-19c8e5f24b70'
],
'job_locations' => [
'US',
'SG',
'CN'
],
'job_exclude_locations' => [
'CN',
'US',
'RU',
'CA'
],
'job_posted_dates' => [
'2025-01-01',
'2025-01-10'
],
'job_titles' => [
'sales manager',
'marketing manager'
],
'advertisement_target_locations' => [
'TW',
'AE',
'NO'
],
'advertisement_exclude_target_locations' => [
'IS',
'GB',
'FR',
'IE',
'ES'
],
'advertisement_search_terms' => [
'asus'
],
'advertisement_start_dates' => [
'2025-12-25',
'2025-12-25'
],
'advertisement_end_dates' => [
'2025-12-25',
'2025-12-25'
],
'news_categories' => [
'launches'
],
'news_published_dates' => [
'2025-01-01',
'2025-01-10'
],
'transitioned_dates' => [
'2026-04-01',
'2026-06-29'
],
'window_days' => 90,
'query' => 'fintech companies expanding into the UK',
'is_explain_match' => true,
'sort_by' => 'expansion_score',
'is_include_metadata' => true,
'page' => 1,
'per_page' => 25,
'is_enable_similarity_search' => true,
'filter_conditions' => [
[
'key' => 'keywords',
'operator' => 'or'
]
]
]),
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/expansions/search"
payload := strings.NewReader("{\n \"froms\": [\n \"US\",\n \"GB\"\n ],\n \"tos\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_froms\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_tos\": [\n \"US\",\n \"GB\"\n ],\n \"stages\": [\n \"committing\",\n \"expanding\"\n ],\n \"momentum\": [\n \"advancing\",\n \"steady\"\n ],\n \"freshness\": [\n \"fresh\",\n \"cooling\"\n ],\n \"scopes\": [\n \"entering_new_market\"\n ],\n \"ahead_of_pace\": false,\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"min_markets\": 3,\n \"home_country_code\": [\n \"SG\"\n ],\n \"industries\": [\n \"software\",\n \"financial services\"\n ],\n \"exclude_industries\": [\n \"tobacco\"\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_categories\": [\n 123\n ],\n \"technologies\": [\n 123\n ],\n \"employees\": [\n [\n 1,\n 10\n ],\n [\n 11,\n 20\n ],\n [\n 10001\n ]\n ],\n \"revenues\": [\n 0,\n 100000\n ],\n \"founded_dates\": [\n 2018,\n 2024\n ],\n \"keywords\": [\n \"ecommerce\",\n \"ai\",\n \"fintech\"\n ],\n \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\n ],\n \"job_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"job_exclude_locations\": [\n \"CN\",\n \"US\",\n \"RU\",\n \"CA\"\n ],\n \"job_posted_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"job_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"advertisement_target_locations\": [\n \"TW\",\n \"AE\",\n \"NO\"\n ],\n \"advertisement_exclude_target_locations\": [\n \"IS\",\n \"GB\",\n \"FR\",\n \"IE\",\n \"ES\"\n ],\n \"advertisement_search_terms\": [\n \"asus\"\n ],\n \"advertisement_start_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"advertisement_end_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"news_categories\": [\n \"launches\"\n ],\n \"news_published_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"fintech companies expanding into the UK\",\n \"is_explain_match\": true,\n \"sort_by\": \"expansion_score\",\n \"is_include_metadata\": true,\n \"page\": 1,\n \"per_page\": 25,\n \"is_enable_similarity_search\": true,\n \"filter_conditions\": [\n {\n \"key\": \"keywords\",\n \"operator\": \"or\"\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/expansions/search")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"froms\": [\n \"US\",\n \"GB\"\n ],\n \"tos\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_froms\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_tos\": [\n \"US\",\n \"GB\"\n ],\n \"stages\": [\n \"committing\",\n \"expanding\"\n ],\n \"momentum\": [\n \"advancing\",\n \"steady\"\n ],\n \"freshness\": [\n \"fresh\",\n \"cooling\"\n ],\n \"scopes\": [\n \"entering_new_market\"\n ],\n \"ahead_of_pace\": false,\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"min_markets\": 3,\n \"home_country_code\": [\n \"SG\"\n ],\n \"industries\": [\n \"software\",\n \"financial services\"\n ],\n \"exclude_industries\": [\n \"tobacco\"\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_categories\": [\n 123\n ],\n \"technologies\": [\n 123\n ],\n \"employees\": [\n [\n 1,\n 10\n ],\n [\n 11,\n 20\n ],\n [\n 10001\n ]\n ],\n \"revenues\": [\n 0,\n 100000\n ],\n \"founded_dates\": [\n 2018,\n 2024\n ],\n \"keywords\": [\n \"ecommerce\",\n \"ai\",\n \"fintech\"\n ],\n \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\n ],\n \"job_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"job_exclude_locations\": [\n \"CN\",\n \"US\",\n \"RU\",\n \"CA\"\n ],\n \"job_posted_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"job_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"advertisement_target_locations\": [\n \"TW\",\n \"AE\",\n \"NO\"\n ],\n \"advertisement_exclude_target_locations\": [\n \"IS\",\n \"GB\",\n \"FR\",\n \"IE\",\n \"ES\"\n ],\n \"advertisement_search_terms\": [\n \"asus\"\n ],\n \"advertisement_start_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"advertisement_end_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"news_categories\": [\n \"launches\"\n ],\n \"news_published_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"fintech companies expanding into the UK\",\n \"is_explain_match\": true,\n \"sort_by\": \"expansion_score\",\n \"is_include_metadata\": true,\n \"page\": 1,\n \"per_page\": 25,\n \"is_enable_similarity_search\": true,\n \"filter_conditions\": [\n {\n \"key\": \"keywords\",\n \"operator\": \"or\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/expansions/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 \"froms\": [\n \"US\",\n \"GB\"\n ],\n \"tos\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_froms\": [\n \"US\",\n \"GB\"\n ],\n \"exclude_tos\": [\n \"US\",\n \"GB\"\n ],\n \"stages\": [\n \"committing\",\n \"expanding\"\n ],\n \"momentum\": [\n \"advancing\",\n \"steady\"\n ],\n \"freshness\": [\n \"fresh\",\n \"cooling\"\n ],\n \"scopes\": [\n \"entering_new_market\"\n ],\n \"ahead_of_pace\": false,\n \"signal_types\": [\n \"EXEC\",\n \"HIRE\"\n ],\n \"signal_strengths\": [\n \"high\"\n ],\n \"min_signal_count\": 3,\n \"only_contraction\": false,\n \"min_markets\": 3,\n \"home_country_code\": [\n \"SG\"\n ],\n \"industries\": [\n \"software\",\n \"financial services\"\n ],\n \"exclude_industries\": [\n \"tobacco\"\n ],\n \"verticals\": [\n 123\n ],\n \"vertical_categories\": [\n 123\n ],\n \"vertical_sub_categories\": [\n 123\n ],\n \"technologies\": [\n 123\n ],\n \"employees\": [\n [\n 1,\n 10\n ],\n [\n 11,\n 20\n ],\n [\n 10001\n ]\n ],\n \"revenues\": [\n 0,\n 100000\n ],\n \"founded_dates\": [\n 2018,\n 2024\n ],\n \"keywords\": [\n \"ecommerce\",\n \"ai\",\n \"fintech\"\n ],\n \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70\"\n ],\n \"job_locations\": [\n \"US\",\n \"SG\",\n \"CN\"\n ],\n \"job_exclude_locations\": [\n \"CN\",\n \"US\",\n \"RU\",\n \"CA\"\n ],\n \"job_posted_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"job_titles\": [\n \"sales manager\",\n \"marketing manager\"\n ],\n \"advertisement_target_locations\": [\n \"TW\",\n \"AE\",\n \"NO\"\n ],\n \"advertisement_exclude_target_locations\": [\n \"IS\",\n \"GB\",\n \"FR\",\n \"IE\",\n \"ES\"\n ],\n \"advertisement_search_terms\": [\n \"asus\"\n ],\n \"advertisement_start_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"advertisement_end_dates\": [\n \"2025-12-25\",\n \"2025-12-25\"\n ],\n \"news_categories\": [\n \"launches\"\n ],\n \"news_published_dates\": [\n \"2025-01-01\",\n \"2025-01-10\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"query\": \"fintech companies expanding into the UK\",\n \"is_explain_match\": true,\n \"sort_by\": \"expansion_score\",\n \"is_include_metadata\": true,\n \"page\": 1,\n \"per_page\": 25,\n \"is_enable_similarity_search\": true,\n \"filter_conditions\": [\n {\n \"key\": \"keywords\",\n \"operator\": \"or\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"metadata": {
"filters": {
"tos": [
"GB"
],
"verticals": [
"Financial Services"
]
}
},
"data": {
"pagination": {
"page": 1,
"per_page": 25,
"total_entries": 87,
"total_pages": 4,
"total_display_pages": 4,
"is_timeout": false
},
"companies": [
{
"expansion_id": "6845525",
"domain_search_id": "8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c",
"country_code": "GB",
"target_country_code": "GB",
"domain": "example.com",
"company_name": "Example Corp",
"home_country_code": "CN",
"industry": "Consumer Electronics",
"founded_year": 2015,
"employees_count": 320,
"stage": {
"slug": "expanding",
"expansion_score": 0.72,
"scope": "entering_new_market",
"direction": "advancing",
"freshness": "fresh",
"signal_count": 27,
"distinct_type_count": 3,
"last_transition_at": "2026-06-27T14:32:10.000Z"
},
"presence": {
"level": "established",
"local_people_count": 12,
"matched_rule": "headcount",
"has_known_office": true,
"established_min": 10,
"share_of_detected": 0.54
},
"read": {
"code": "establishing"
}
}
]
}
}{
"code": 40001,
"message": "오류 코드 및 메시지는 상황에 따라 다를 수 있습니다. 자세한 내용은 문서를 참조하세요.",
"details": {}
}{
"error": "요청 빈도가 제한을 초과했습니다. 잠시 후 다시 시도해주세요."
}{
"error": "요청을 처리하는 중 서버에서 예기치 않은 오류가 발생했습니다"
}본문
application/json
- 출발 시장
- 대상 시장
- 자연어 질의
- 기업 지정
출발 시장(ISO 3166-1 alpha-2). 기업이 어디에서부터 확장하는지 — 본사 / 모국. 단독으로 사용하면 이 시장에서 밖으로 확장하는 기업을 찾고, tos와 함께 사용하면 특정 출발→도착 코리도를 지정합니다.
예시:
["US", "GB"]
도착 시장(ISO 3166-1 alpha-2). 기업이 어디로 확장하는지. 단독으로 사용하면 이 시장에 진입하는 모든 기업을 찾고, froms와 함께 사용하면 특정 출발→도착 코리도를 지정합니다.
예시:
["US", "GB"]
제외할 출발 시장(ISO 3166-1 alpha-2).
예시:
["US", "GB"]
제외할 도착 시장(ISO 3166-1 alpha-2).
예시:
["US", "GB"]
값은 대소문자를 구분하며 검증되지 않습니다. 인식되지 않는 값은 오류가 아니라 조용히 버려집니다. stages, freshness, scopes, momentum에서는 필터 전체가 버려져 필터링되지 않은 결과가 반환되고, signal_types와 signal_strengths에서는 필터가 적용되어 아무것도 일치하지 않습니다. 두 경우 모두 응답은 정상으로 보입니다. 유효한 슬러그는 Expansion Reference에서 확인하고, 결과가 이상해 보이면 data.pagination.total_entries를 필터 없는 호출과 비교하세요.
사용 가능한 옵션:
exploring, committing, expanding, scaling 예시:
["committing", "expanding"]
해당 시장에서 기업의 추세입니다. advancing은 전진, steady는 유지, pulling_back은 축소와 철수를 포괄합니다.
여기에 Expansion Reference의 directions 값을 사용하지 마세요. 해당 값(advancing, steady, retreating, new)은 stage.direction으로 반환되는 응답 값이며, 필터로 허용되는 것은 위의 세 가지뿐입니다. retreating이나 new를 전달하면 필터가 조용히 비활성화되어 필터링되지 않은 결과가 반환됩니다.
사용 가능한 옵션:
advancing, steady, pulling_back 예시:
["advancing", "steady"]
값은 대소문자를 구분하며 검증되지 않습니다. 인식되지 않는 값은 오류가 아니라 조용히 버려집니다. stages, freshness, scopes, momentum에서는 필터 전체가 버려져 필터링되지 않은 결과가 반환되고, signal_types와 signal_strengths에서는 필터가 적용되어 아무것도 일치하지 않습니다. 두 경우 모두 응답은 정상으로 보입니다. 유효한 슬러그는 Expansion Reference에서 확인하고, 결과가 이상해 보이면 data.pagination.total_entries를 필터 없는 호출과 비교하세요.
사용 가능한 옵션:
fresh, cooling, stale, cold 예시:
["fresh", "cooling"]
시장 진입 범위로 필터링합니다.
사용 가능한 옵션:
entering_new_market, expanding_within_presence, established_only 예시:
["entering_new_market"]
해당 시장의 일반적인 속도보다 빠르게 움직이는 쌍으로 제한합니다.
예시:
false
값은 대소문자를 구분하며 검증되지 않습니다. 인식되지 않는 값은 오류가 아니라 조용히 버려집니다. stages, freshness, scopes, momentum에서는 필터 전체가 버려져 필터링되지 않은 결과가 반환되고, signal_types와 signal_strengths에서는 필터가 적용되어 아무것도 일치하지 않습니다. 두 경우 모두 응답은 정상으로 보입니다. 유효한 슬러그는 Expansion Reference에서 확인하고, 결과가 이상해 보이면 data.pagination.total_entries를 필터 없는 호출과 비교하세요.
사용 가능한 옵션:
AD, AUDIENCE, DNS, ENTITY, EVENT, EVENT_PLUS, EXEC, HIRE, INFRA, IP, NEWS, OFFICE, PARTNER, PRODUCT, REG, SCALE, TECH 예시:
["EXEC", "HIRE"]
값은 대소문자를 구분하며 검증되지 않습니다. 인식되지 않는 값은 오류가 아니라 조용히 버려집니다. stages, freshness, scopes, momentum에서는 필터 전체가 버려져 필터링되지 않은 결과가 반환되고, signal_types와 signal_strengths에서는 필터가 적용되어 아무것도 일치하지 않습니다. 두 경우 모두 응답은 정상으로 보입니다. 유효한 슬러그는 Expansion Reference에서 확인하고, 결과가 이상해 보이면 data.pagination.total_entries를 필터 없는 호출과 비교하세요.
사용 가능한 옵션:
low, medium, high, very_high 예시:
["high"]
해당 기간 동안 회사가 보유해야 하는 최소 확장 신호 수입니다 — "매우 활발함 / 활동 범위가 넓음"을 걸러냅니다.
예시:
3
true인 경우 축소로 표시된 확장만 반환합니다(규모를 축소하는 회사).
예시:
false
해당 기간 내에 회사가 진입해야 하는 신규 시장의 최소 개수.
예시:
3
회사의 본국으로 필터링합니다(ISO 3166-1 alpha-2). froms와 함께 제공되면 교집합이 적용됩니다.
예시:
["SG"]
산업 이름으로 필터링합니다(자유 텍스트 매칭).
예시:
["software", "financial services"]
제외할 산업입니다(자유 텍스트 매칭).
예시:
["tobacco"]
vertical_id 목록으로, 특정 산업 또는 분야의 회사를 검색합니다. ID를 얻으려면 필터 탭의 vertical 엔드포인트를 호출하세요.
이 필터는 is_enable_similarity_search를 지원하며, ["AI"]와 같은 자유 텍스트 검색이 가능합니다.
vertical_category_id 목록으로, 특정 산업 카테고리에 속한 회사를 검색합니다. ID를 얻으려면 필터 탭의 vertical category 엔드포인트를 호출하세요.
이 필터는 is_enable_similarity_search를 지원하며 ["Information Technology"]와 같은 텍스트 입력이 가능합니다.
vertical_sub_category_id 목록으로, 특정 산업 하위 카테고리에 속한 회사를 검색합니다. ID를 얻으려면 필터 탭의 vertical sub category 엔드포인트를 호출하세요.
이 필터는 is_enable_similarity_search를 지원하며 ["Software"]와 같은 자유 텍스트 검색이 가능합니다.
tag_id 목록으로, 특정 기술을 사용하는 회사를 검색하는 데 사용됩니다. ID를 얻으려면 필터 탭의 technology 엔드포인트를 호출하세요.
이 필터는 is_enable_similarity_search를 지원하며, 활성화 시 ["Shopify"]와 같은 자유 텍스트 입력이 가능합니다.
기술 목록에 있는 제품 이름은 해당 제품과 그 자사 제품에 일치합니다("Salesforce"는 Salesforce Desk와 Salesforce Service Cloud에도 일치). 비슷한 다른 제품에는 일치하지 않으며, 그 밖의 텍스트는 유사도로 일치합니다.
회사 직원 수 범위입니다. 총 직원 수를 기준으로 회사를 필터링할 수 있으며, 여러 범위를 추가해 검색 결과를 확장할 수 있습니다.
자세한 내용은 필터 탭의 company size 엔드포인트를 참조하세요.
예시:
[[1, 10], [11, 20], [10001]]
회사의 최소 및 최대 수익 범위입니다.
예시:
[0, 100000]
회사의 설립 연도 범위입니다. 최대값은 현재 연도입니다.
예시:
[2018, 2024]
회사 검색 결과를 관련성, 전문 분야 또는 설명으로 필터링하기 위한 키워드 목록입니다.
예시:
["ecommerce", "ai", "fintech"]
domain_search_id, 회사 도메인 또는 회사 소셜 미디어 프로필 URL의 임의 조합으로 회사를 지정합니다. 도메인과 URL은 순위가 가장 높은 회사로 확인됩니다.
예시:
[
"stripe.com",
"https://www.linkedin.com/company/airbnb",
"b7d92a56-31f8-4c0b-ae43-19c8e5f24b70"
]
ISO 3166-1 alpha-2(cca2) 코드로 지역을 필터링하는 데 사용됩니다. 자세한 내용은 필터 탭의 location 엔드포인트를 참조하세요.
예시:
["US", "SG", "CN"]
채용 공고 결과에서 제외할 지리적 위치.
예시:
["CN", "US", "RU", "CA"]
게시 날짜 범위입니다. 최대값은 오늘 날짜입니다. 날짜 경계는 워크스페이스 시간대를 따릅니다.
예시:
["2025-01-01", "2025-01-10"]
검색 대상 인물의 직함입니다.
software engineer를 검색하면 senior software engineer와 같이 유사한 용어를 포함한 결과도 반환될 수 있습니다.
예시:
["sales manager", "marketing manager"]
광고의 대상 지리적 위치.
예시:
["TW", "AE", "NO"]
광고 타겟팅에서 제외할 지리적 위치.
예시:
["IS", "GB", "FR", "IE", "ES"]
광고 콘텐츠 또는 제목 내에서 검색하는 데 사용되는 키워드입니다.
예시:
["asus"]
광고 필터링을 위한 시작 날짜 범위입니다.
예시:
["2025-12-25", "2025-12-25"]
광고 필터링을 위한 종료 날짜 범위입니다.
예시:
["2025-12-25", "2025-12-25"]
category slugs 목록으로, 특정 뉴스 카테고리를 검색합니다. slug를 얻으려면 필터 탭의 news categories 엔드포인트를 호출하세요.
예시:
["launches"]
발행 날짜 범위입니다. 최대값은 오늘 날짜입니다. 날짜 경계는 워크스페이스 시간대를 따릅니다.
예시:
["2025-01-01", "2025-01-10"]
타임라인 윈도우의 ISO 날짜 범위입니다. 기본값은 최근 90일입니다. A natural-language query may also set this from calendar phrases ("this year", "last year", "Q2 2026").
예시:
["2026-04-01", "2026-06-29"]
선택 사항. 롤링 윈도우의 일수입니다. 명시적인 transitioned_dates 범위가 제공되지 않을 때 사용되며, 둘 다 생략하면 기본 윈도우가 사용됩니다.
예시:
90
Pubrio가 확장 및 회사 필터로 해석하는 자연어 쿼리.
예시:
"fintech companies expanding into the UK"
각 회사가 검색 조건에 부합하는 이유에 대한 AI 생성 설명을 회사의 실제 신호를 근거로 포함합니다. 자연어 쿼리와 함께 사용하는 것이 가장 좋습니다. 인용되는 신호의 수와 배치 크기는 모두 per_page에 따라 달라집니다. 채용 공고, 광고 캠페인처럼 발생 빈도가 높은 소스는 개별적으로 나열하지 않고 해당 기간 동안의 건수로 요약되어 표시됩니다(예: "12건의 채용 공고").
예시:
true
결과 정렬 방식입니다. 생략하면 기본 관련성 순서가 적용됩니다: 상호 검증된 쌍(2개 이상의 서로 다른 신호 유형)이 먼저, 그다음 반복 증거 쌍(3개 이상의 신호), 그다음 나머지 — 각 계층 내에서는 가장 최근에 전환된 순입니다. recent — 순수 최신순(가장 최근에 전환된 순). expansion_score — 확장 점수가 높은 순. signal_count — 해당 쌍의 신호 수가 많은 순. company_ranking — Pubrio의 전체 기업 순위 기준(숫자가 작을수록 더 두드러짐), 오름차순.
사용 가능한 옵션:
recent, expansion_score, signal_count, company_ranking 예시:
"expansion_score"
전체 상세 페이로드를 반환합니다. API 키 트래픽은 기본적으로 경량 응답입니다. 이 값이 true가 아니면 model 블록, 신뢰도 값(기업 확장 상세의 stage.confidence, other_markets[] 및 순위 markers[]의 confidence_score), 그리고 established_min / share_of_detected / has_known_office 필드가 모두 생략됩니다.
예시:
true
verticals, vertical_categories, vertical_sub_categories, technologies의 자유 텍스트 매칭을 활성화합니다. 활성화하지 않으면 해당 필터의 자유 텍스트 값은 아무것도 일치하지 않습니다.
예시:
true
회사 검색을 위한 고급 필터링 옵션입니다. 키와 논리 연산자를 결합한 조건을 지정하여 검색 결과를 세분화하세요.
Show child attributes
Show child attributes
응답
대상 시장에서 확장 중인 회사의 페이지네이션 목록입니다. filters는 적용된(또는 자연어로 해석된) 조건을 반영하며, is_explain_match가 true이면 각 회사에 match_summary가 포함됩니다.
마지막 수정일 2026년 8월 28일