扩张搜索
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": [
"accelerating",
"advancing"
],
"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",
"550e8400-e29b-41d4-a716-446655440000"
],
"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
}
'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": ["accelerating", "advancing"],
"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", "550e8400-e29b-41d4-a716-446655440000"],
"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
}
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: ['accelerating', 'advancing'],
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',
'550e8400-e29b-41d4-a716-446655440000'
],
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
})
};
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' => [
'accelerating',
'advancing'
],
'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',
'550e8400-e29b-41d4-a716-446655440000'
],
'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
]),
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 \"accelerating\",\n \"advancing\"\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 \"550e8400-e29b-41d4-a716-446655440000\"\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}")
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 \"accelerating\",\n \"advancing\"\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 \"550e8400-e29b-41d4-a716-446655440000\"\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}")
.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 \"accelerating\",\n \"advancing\"\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 \"550e8400-e29b-41d4-a716-446655440000\"\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}"
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": "550e8400-e29b-41d4-a716-446655440002",
"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"
}
}
]
}
}扩张
扩张搜索
查找正在向一个或多个市场扩张的公司，可使用企业和信号筛选条件或自然语言查询，并可选择生成基于该公司真实信号的 AI 匹配说明。
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": [
"accelerating",
"advancing"
],
"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",
"550e8400-e29b-41d4-a716-446655440000"
],
"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
}
'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": ["accelerating", "advancing"],
"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", "550e8400-e29b-41d4-a716-446655440000"],
"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
}
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: ['accelerating', 'advancing'],
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',
'550e8400-e29b-41d4-a716-446655440000'
],
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
})
};
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' => [
'accelerating',
'advancing'
],
'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',
'550e8400-e29b-41d4-a716-446655440000'
],
'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
]),
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 \"accelerating\",\n \"advancing\"\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 \"550e8400-e29b-41d4-a716-446655440000\"\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}")
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 \"accelerating\",\n \"advancing\"\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 \"550e8400-e29b-41d4-a716-446655440000\"\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}")
.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 \"accelerating\",\n \"advancing\"\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 \"550e8400-e29b-41d4-a716-446655440000\"\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}"
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": "550e8400-e29b-41d4-a716-446655440002",
"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"
}
}
]
}
}请求体
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, established 示例:
["committing", "expanding"]
公司在该市场中的走势。advancing 表示正在推进，steady 表示保持稳定，pulling_back 涵盖收缩与撤退。
请不要在此处使用 Expansion Reference 中 directions 的取值。那些取值（advancing、steady、retreating、new）是你在 stage.direction 中收到的响应值；作为筛选条件仅接受上面列出的三个。传入 retreating 或 new 会静默禁用该筛选条件并返回未经筛选的结果。
可用选项:
accelerating, advancing, steady, pulling_back 示例:
["accelerating", "advancing"]
取值区分大小写，且不会被校验。无法识别的取值会被静默丢弃而非报错：在 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, NEWS, DNS, INFRA, PARTNER, EVENT_PLUS, EXEC, OFFICE, HIRE, SCALE, PRODUCT 示例:
["EXEC", "HIRE"]
取值区分大小写，且不会被校验。无法识别的取值会被静默丢弃而非报错：在 stages、freshness、scopes 和 momentum 上，整个筛选条件会被丢弃，你将得到未经筛选的结果；而在 signal_types 和 signal_strengths 上，筛选条件会被应用但不匹配任何内容。两种情况下响应看起来都很正常。请通过 Expansion Reference 获取有效的标识值；若结果集看起来异常，请将 data.pagination.total_entries 与未加筛选的调用进行对比。
可用选项:
low, medium, 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"]。
公司员工人数范围。可根据员工总数筛选公司，并可添加多个范围以扩展搜索结果。
更多信息请参见筛选器标签下的 company size 端点。
示例:
[[1, 10], [11, 20], [10001]]
公司收入的最小值和最大值范围。
示例:
[0, 100000]
公司成立年份范围。最大值为当前年份。
示例:
[2018, 2024]
用于按相关性、专业或描述对公司进行关键词筛选的列表。
示例:
["ecommerce", "ai", "fintech"]
通过 domain_search_id、公司域名或公司社交媒体主页链接的任意组合来指定公司。域名和链接会解析为排名最高的公司。
示例:
[
"stripe.com",
"https://www.linkedin.com/company/airbnb",
"550e8400-e29b-41d4-a716-446655440000"
]
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
响应
200 - application/json
在目标市场扩张的公司分页列表。filters 会回显已应用（或自然语言解析）的条件；当 is_explain_match 为 true 时，每家公司都会包含 match_summary。
⌘I