跳转到主要内容
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",
    "very_high"
  ],
  "min_signal_count": 3,
  "only_contraction": false,
  "min_markets": 3,
  "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",
  "page": 1,
  "per_page": 25,
  "profile_id": 123
}
'
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", "very_high"],
    "min_signal_count": 3,
    "only_contraction": False,
    "min_markets": 3,
    "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",
    "page": 1,
    "per_page": 25,
    "profile_id": 123
}
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', 'very_high'],
    min_signal_count: 3,
    only_contraction: false,
    min_markets: 3,
    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',
    page: 1,
    per_page: 25,
    profile_id: 123
  })
};

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',
        'very_high'
    ],
    'min_signal_count' => 3,
    'only_contraction' => false,
    'min_markets' => 3,
    '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',
    'page' => 1,
    'per_page' => 25,
    'profile_id' => 123
  ]),
  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    \"very_high\"\n  ],\n  \"min_signal_count\": 3,\n  \"only_contraction\": false,\n  \"min_markets\": 3,\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  \"page\": 1,\n  \"per_page\": 25,\n  \"profile_id\": 123\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    \"very_high\"\n  ],\n  \"min_signal_count\": 3,\n  \"only_contraction\": false,\n  \"min_markets\": 3,\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  \"page\": 1,\n  \"per_page\": 25,\n  \"profile_id\": 123\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    \"very_high\"\n  ],\n  \"min_signal_count\": 3,\n  \"only_contraction\": false,\n  \"min_markets\": 3,\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  \"page\": 1,\n  \"per_page\": 25,\n  \"profile_id\": 123\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
        },
        "presence": {
          "level": "detected",
          "local_people_count": 12,
          "has_known_office": true,
          "matched_rule": "people"
        },
        "read": {
          "code": "ok"
        }
      }
    ]
  }
}

授权

​
pubrio-api-key
string
header
必填

一个唯一的 API 令牌，用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在 设置 部分创建该令牌。

请求体

application/json
​
froms
string[]

来源市场（ISO 3166-1 alpha-2）。公司从哪些市场向外扩张 —— 即其总部 / 母国。单独使用可查找从这些市场向外扩张的公司；与 tos 组合可指定具体的 来源→目标 走廊。

示例:
["US", "GB"]
​
tos
string[]

目标市场（ISO 3166-1 alpha-2）。公司正在向哪些市场扩张。单独使用可查找进入这些市场的所有公司；与 froms 组合可指定具体的 来源→目标 走廊。

示例:
["US", "GB"]
​
exclude_froms
string[]

要排除的来源市场（ISO 3166-1 alpha-2）。

示例:
["US", "GB"]
​
exclude_tos
string[]

要排除的目标市场（ISO 3166-1 alpha-2）。

示例:
["US", "GB"]
​
stages
enum<string>[]

筛选至一个或多个扩张阶段。阶段的具体定义请参见 Expansion Signals 知识库。

可用选项:
exploring,
committing,
expanding,
scaling,
established
示例:
["committing", "expanding"]
​
momentum
enum<string>[]

按扩张动量(在各阶段间的变化轨迹)筛选:accelerating(伴随模式变化的加速前进)、advancing(前进)、steady(平稳)或 pulling_back(后退或收缩)。

可用选项:
accelerating,
advancing,
steady,
pulling_back
示例:
["accelerating", "advancing"]
​
freshness
enum<string>[]

按证据近期性筛选：fresh（约 30 天）、cooling（约 30–60 天）、stale（约 60–90 天）、cold（超过 90 天）。

可用选项:
fresh,
cooling,
stale,
cold
示例:
["fresh", "cooling"]
​
scopes
enum<string>[]

按市场进入范围筛选。

可用选项:
entering_new_market,
expanding_within_presence,
established_only
示例:
["entering_new_market"]
​
ahead_of_pace
boolean

仅限扩张速度快于该市场典型速度的组合。

示例:

false

​
signal_types
enum<string>[]

筛选到特定的信号类型。

可用选项:
AD,
NEWS,
INFRA,
PARTNER,
EVENT_PLUS,
EXEC,
OFFICE,
HIRE,
SCALE,
PRODUCT
示例:
["EXEC", "HIRE"]
​
signal_strengths
enum<string>[]

按信号强度区间筛选。

可用选项:
low,
medium,
high,
very_high
示例:
["high", "very_high"]
​
min_signal_count
integer

公司在该时间窗口内所需的最少扩张信号数量——用于筛选“非常活跃 / 足迹密集”的公司。

示例:

3

​
only_contraction
boolean

为 true 时，仅返回标记为收缩的扩张记录（正在收缩规模的公司）。

示例:

false

​
min_markets
integer

公司在该时间窗口内必须进入的新市场最少数量。

示例:

3

​
verticals
integer[]

vertical_id 列表，用于搜索特定垂直行业或领域的公司。要获取ID，请调用筛选器标签下的 vertical 端点。

该筛选器支持 is_enable_similarity_search，启用后可输入任意自由文本，例如 ["AI"]。

​
vertical_categories
integer[]

vertical_category_id 列表，用于搜索特定垂直行业类别的公司。要获取ID，请调用筛选器标签下的 vertical category 端点。

该筛选器支持 is_enable_similarity_search，启用后可输入任意自由文本，例如 ["Information Technology"]。

​
vertical_sub_categories
integer[]

vertical_sub_category_id 列表，用于搜索特定垂直行业子类别的公司。要获取ID，请调用筛选器标签下的 vertical sub category 端点。

该筛选器支持 is_enable_similarity_search，启用后可输入任意自由文本，例如 ["Software"]。

​
technologies
integer[]

tag_id 列表，用于搜索公司所用的特定技术。要获取ID，请调用筛选器标签下的 technology 端点。

该筛选器支持 is_enable_similarity_search，启用后可输入任意自由文本，例如 ["Shopify"]。

​
employees
string[][]

公司员工人数范围。可根据员工总数筛选公司，并可添加多个范围以扩展搜索结果。

更多信息请参见筛选器标签下的 company size 端点。

示例:
[[1, 10], [11, 20], [10001]]
​
revenues
integer[]

公司收入的最小值和最大值范围。

示例:
[0, 100000]
​
founded_dates
integer[]

公司成立年份范围。最大值为当前年份。

示例:
[2018, 2024]
​
keywords
string[]

用于按相关性、专业或描述对公司进行关键词筛选的列表。

示例:
["ecommerce", "ai", "fintech"]
​
companies
string[]

通过 domain_search_id、公司域名或公司社交媒体主页链接的任意组合来指定公司。域名和链接会解析为排名最高的公司。

示例:
[
  "stripe.com",
  "https://www.linkedin.com/company/airbnb",
  "550e8400-e29b-41d4-a716-446655440000"
]
​
job_locations
string[]

ISO 3166-1 alpha-2（cca2）用于筛选地区。更多信息请参见筛选器标签下的 location 端点。

示例:
["US", "SG", "CN"]
​
job_exclude_locations
string[]

从职位发布结果中排除的地理位置。

示例:
["CN", "US", "RU", "CA"]
​
job_posted_dates
string[]

发布日期的时间范围。最大值为当天。

示例:
["2025-01-01", "2025-01-10"]
​
job_titles
string[]

与目标人员相关的职位名称。

结果还将包含包含类似术语的职位，即使不完全匹配。例如，搜索 software engineer 也可能返回职位为 senior software engineer 的人员。

示例:
["sales manager", "marketing manager"]
​
advertisement_target_locations
string[]

广告的目标地理位置。

示例:
["TW", "AE", "NO"]
​
advertisement_exclude_target_locations
string[]

从广告定位中排除的地理位置。

示例:
["IS", "GB", "FR", "IE", "ES"]
​
advertisement_search_terms
string[]

用于在广告内容或标题中搜索的关键词。

示例:
["asus"]
​
advertisement_start_dates
string<date>[]

用于广告筛选的起始日期范围。

示例:
["2025-12-25", "2025-12-25"]
​
advertisement_end_dates
string<date>[]

用于广告筛选的结束日期范围。

示例:
["2025-12-25", "2025-12-25"]
​
news_categories
string[]

category slugs 列表，用于搜索特定新闻类别。要获取 slug，请调用筛选器标签下的 news categories 端点。

示例:
["launches"]
​
news_published_dates
string[]

发布时间的时间范围。最大值为当天。

示例:
["2025-01-01", "2025-01-10"]
​
transitioned_dates
string<date>[]

时间线窗口的 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"]
​
window_days
integer

可选。滚动时间窗口的天数。在未提供明确的 transitioned_dates 范围时使用;若两者均未提供,则使用默认时间窗口。

示例:

90

​
query
string

Pubrio 将其解析为扩张与公司筛选条件的自然语言查询。

示例:

"fintech companies expanding into the UK"

​
is_explain_match
boolean

为每家公司附上其匹配搜索条件原因的 AI 生成说明（基于公司的真实信号）。建议配合自然语言查询使用。 引用的信号数量及批处理规模均随 per_page 变化；高频来源（招聘信息、广告投放）会以窗口期内的数量形式汇总（例如"12 个职位发布"），而非逐条列出。

示例:

true

​
sort_by
enum<string>

结果排序方式。留空则使用默认排序（按最近变更时间排序）。expansion_score —— 按扩张分数从高到低排序。signal_count —— 按该组合的信号数量从多到少排序。company_ranking —— 按 Pubrio 的整体公司排名排序（数值越小代表越知名），从小到大排列。

可用选项:
expansion_score,
signal_count,
company_ranking
示例:

"expansion_score"

​
page
integer

要检索的数据页码。

示例:

1

​
per_page
integer

每页应返回的搜索结果数量。限制每页结果数量可提升接口性能。

示例:

25

​
profile_id
integer

可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID 有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。

更多信息请参见团队标签下的 user details 端点。

响应

200 - application/json

在目标市场扩张的公司分页列表。filters 会回显已应用（或自然语言解析）的条件；当 is_explain_match 为 true 时，每家公司都会包含 match_summary。

​
metadata
object

搜索元数据：实际应用的筛选器，以及在请求元数据时的市场汇总（aggregate、地理范围、top origins/destinations/industries、timeline）。

​
data
object

结果容器（标准搜索信封）：公司列表加分页。