批量获取公司扩张摘要
curl --request POST \
--url https://api.pubrio.com/expansions/companies/summaries \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"companies": [
"stripe.com",
"https://www.linkedin.com/company/airbnb",
"550e8400-e29b-41d4-a716-446655440000"
],
"domains": [
"pubrio.com"
],
"linkedin_urls": [
"https://www.linkedin.com/company/pubrio"
],
"transitioned_dates": [
"2026-04-01",
"2026-06-29"
],
"window_days": 90,
"is_include_established": false,
"is_include_metadata": true
}
'import requests
url = "https://api.pubrio.com/expansions/companies/summaries"
payload = {
"companies": ["stripe.com", "https://www.linkedin.com/company/airbnb", "550e8400-e29b-41d4-a716-446655440000"],
"domains": ["pubrio.com"],
"linkedin_urls": ["https://www.linkedin.com/company/pubrio"],
"transitioned_dates": ["2026-04-01", "2026-06-29"],
"window_days": 90,
"is_include_established": False,
"is_include_metadata": True
}
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({
companies: [
'stripe.com',
'https://www.linkedin.com/company/airbnb',
'550e8400-e29b-41d4-a716-446655440000'
],
domains: ['pubrio.com'],
linkedin_urls: ['https://www.linkedin.com/company/pubrio'],
transitioned_dates: ['2026-04-01', '2026-06-29'],
window_days: 90,
is_include_established: false,
is_include_metadata: true
})
};
fetch('https://api.pubrio.com/expansions/companies/summaries', 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/companies/summaries",
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([
'companies' => [
'stripe.com',
'https://www.linkedin.com/company/airbnb',
'550e8400-e29b-41d4-a716-446655440000'
],
'domains' => [
'pubrio.com'
],
'linkedin_urls' => [
'https://www.linkedin.com/company/pubrio'
],
'transitioned_dates' => [
'2026-04-01',
'2026-06-29'
],
'window_days' => 90,
'is_include_established' => false,
'is_include_metadata' => true
]),
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/companies/summaries"
payload := strings.NewReader("{\n \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"550e8400-e29b-41d4-a716-446655440000\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"is_include_established\": false,\n \"is_include_metadata\": true\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/companies/summaries")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"550e8400-e29b-41d4-a716-446655440000\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"is_include_established\": false,\n \"is_include_metadata\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/expansions/companies/summaries")
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 \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"550e8400-e29b-41d4-a716-446655440000\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"is_include_established\": false,\n \"is_include_metadata\": true\n}"
response = http.request(request)
puts response.read_body{
"metadata": {},
"data": {
"companies": [
{
"domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
"home_country_code": "SG",
"expansion_score": 82,
"firmographics": {
"domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
"company_name": "Example Corp",
"domain": "example.com",
"logo_url": "https://logo.pubrio.com/example.com.png",
"country_code": "SG",
"company_size": null,
"employees_count": 350,
"company_size_printed": "351+",
"is_employees_locked": false,
"founded_year": 2015,
"industry": "Software Development",
"publicly_traded_symbol": null,
"estimated_revenue": 25000000
},
"markets_summary": [
{
"country_code": "US",
"stage_slug": "committing",
"signal_count": 12,
"distinct_type_count": 4,
"first_signal_at": "2026-04-02T08:00:00.000Z",
"latest_signal_at": "2026-06-28T10:15:22.000Z",
"last_transition_at": "2026-06-25T14:30:00.000Z",
"expansion_score": 0.685,
"signals": [
{
"signal_type_slug": "EXEC",
"signal_subtype_slug": "country_manager",
"event_date": "2026-06-20T14:00:00.000Z",
"display_label": "Hired Regional VP for North America"
}
]
}
],
"signal_weekly_totals": [
{
"week_start": "2026-06-22",
"signal_type_slug": "HIRE",
"count": 5
}
],
"summary": {
"active_markets": 1,
"total_markets": 1,
"new_markets": 1,
"momentum_pct": 22,
"signal_count": 12,
"window_expansion_score": 69,
"scaling": 0,
"pipeline": 1,
"top_market": {
"country_code": "US",
"country": null,
"stage": "committing"
},
"newest_market": {
"country_code": "US",
"country": null,
"stage": "committing"
},
"activity_weekly": [
3,
5,
4
]
}
}
]
}
}扩张
批量获取公司扩张摘要
为一组公司提供可直接渲染的扩张摘要，便于直接进行横向对比，无需在客户端二次聚合。
POST
/
expansions
/
companies
/
summaries
批量获取公司扩张摘要
curl --request POST \
--url https://api.pubrio.com/expansions/companies/summaries \
--header 'Content-Type: application/json' \
--header 'pubrio-api-key: <api-key>' \
--data '
{
"companies": [
"stripe.com",
"https://www.linkedin.com/company/airbnb",
"550e8400-e29b-41d4-a716-446655440000"
],
"domains": [
"pubrio.com"
],
"linkedin_urls": [
"https://www.linkedin.com/company/pubrio"
],
"transitioned_dates": [
"2026-04-01",
"2026-06-29"
],
"window_days": 90,
"is_include_established": false,
"is_include_metadata": true
}
'import requests
url = "https://api.pubrio.com/expansions/companies/summaries"
payload = {
"companies": ["stripe.com", "https://www.linkedin.com/company/airbnb", "550e8400-e29b-41d4-a716-446655440000"],
"domains": ["pubrio.com"],
"linkedin_urls": ["https://www.linkedin.com/company/pubrio"],
"transitioned_dates": ["2026-04-01", "2026-06-29"],
"window_days": 90,
"is_include_established": False,
"is_include_metadata": True
}
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({
companies: [
'stripe.com',
'https://www.linkedin.com/company/airbnb',
'550e8400-e29b-41d4-a716-446655440000'
],
domains: ['pubrio.com'],
linkedin_urls: ['https://www.linkedin.com/company/pubrio'],
transitioned_dates: ['2026-04-01', '2026-06-29'],
window_days: 90,
is_include_established: false,
is_include_metadata: true
})
};
fetch('https://api.pubrio.com/expansions/companies/summaries', 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/companies/summaries",
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([
'companies' => [
'stripe.com',
'https://www.linkedin.com/company/airbnb',
'550e8400-e29b-41d4-a716-446655440000'
],
'domains' => [
'pubrio.com'
],
'linkedin_urls' => [
'https://www.linkedin.com/company/pubrio'
],
'transitioned_dates' => [
'2026-04-01',
'2026-06-29'
],
'window_days' => 90,
'is_include_established' => false,
'is_include_metadata' => true
]),
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/companies/summaries"
payload := strings.NewReader("{\n \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"550e8400-e29b-41d4-a716-446655440000\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"is_include_established\": false,\n \"is_include_metadata\": true\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/companies/summaries")
.header("pubrio-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"550e8400-e29b-41d4-a716-446655440000\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"is_include_established\": false,\n \"is_include_metadata\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.pubrio.com/expansions/companies/summaries")
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 \"companies\": [\n \"stripe.com\",\n \"https://www.linkedin.com/company/airbnb\",\n \"550e8400-e29b-41d4-a716-446655440000\"\n ],\n \"domains\": [\n \"pubrio.com\"\n ],\n \"linkedin_urls\": [\n \"https://www.linkedin.com/company/pubrio\"\n ],\n \"transitioned_dates\": [\n \"2026-04-01\",\n \"2026-06-29\"\n ],\n \"window_days\": 90,\n \"is_include_established\": false,\n \"is_include_metadata\": true\n}"
response = http.request(request)
puts response.read_body{
"metadata": {},
"data": {
"companies": [
{
"domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
"home_country_code": "SG",
"expansion_score": 82,
"firmographics": {
"domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
"company_name": "Example Corp",
"domain": "example.com",
"logo_url": "https://logo.pubrio.com/example.com.png",
"country_code": "SG",
"company_size": null,
"employees_count": 350,
"company_size_printed": "351+",
"is_employees_locked": false,
"founded_year": 2015,
"industry": "Software Development",
"publicly_traded_symbol": null,
"estimated_revenue": 25000000
},
"markets_summary": [
{
"country_code": "US",
"stage_slug": "committing",
"signal_count": 12,
"distinct_type_count": 4,
"first_signal_at": "2026-04-02T08:00:00.000Z",
"latest_signal_at": "2026-06-28T10:15:22.000Z",
"last_transition_at": "2026-06-25T14:30:00.000Z",
"expansion_score": 0.685,
"signals": [
{
"signal_type_slug": "EXEC",
"signal_subtype_slug": "country_manager",
"event_date": "2026-06-20T14:00:00.000Z",
"display_label": "Hired Regional VP for North America"
}
]
}
],
"signal_weekly_totals": [
{
"week_start": "2026-06-22",
"signal_type_slug": "HIRE",
"count": 5
}
],
"summary": {
"active_markets": 1,
"total_markets": 1,
"new_markets": 1,
"momentum_pct": 22,
"signal_count": 12,
"window_expansion_score": 69,
"scaling": 0,
"pipeline": 1,
"top_market": {
"country_code": "US",
"country": null,
"stage": "committing"
},
"newest_market": {
"country_code": "US",
"country": null,
"stage": "committing"
},
"activity_weekly": [
3,
5,
4
]
}
}
]
}
}请求体
application/json
使用单个 companies 数组来限定公司范围，可混合传入 domain_search_id、公司域名或 LinkedIn URL，匹配结果为并集（而非交集）。为向后兼容，仍支持旧的 domain_search_ids、domains、linkedin_urls 字段。每次请求最多解析 25 家公司。
通过 domain_search_id、公司域名或公司社交媒体主页链接的任意组合来指定公司。域名和链接会解析为排名最高的公司。
示例:
[
"stripe.com",
"https://www.linkedin.com/company/airbnb",
"550e8400-e29b-41d4-a716-446655440000"
]
用于公司和人员检索操作的公司域名列表。如果收到的地址为 www.pubrio.com 或 https://docs.pubrio.com/，系统会自动转换为 pubrio.com 进行处理。
示例:
["pubrio.com"]
LinkedIn 公司主页的完整 URL。URL 需以 http 开头且包含 linkedin.com/company/。
示例:
["https://www.linkedin.com/company/pubrio"]
信号/转换窗口的 ISO [from, to] 日期范围。如果同时提供了 window_days，则此参数优先。
示例:
["2026-04-01", "2026-06-29"]
可选。滚动时间窗口的天数。在未提供明确的 transitioned_dates 范围时使用;若两者均未提供,则使用默认时间窗口。
示例:
90
包含 established 阶段（无活跃扩张信号的长期运营者）。默认为 false。
示例:
false
返回完整的详细信息负载。API 密钥请求默认返回精简结果：除非此项为 true，否则将省略 model 区块、置信度数值（公司扩张详情中的 stage.confidence，以及 other_markets[] 和排名 markers[] 中的 confidence_score），以及 established_min / share_of_detected / has_known_office 字段。
示例:
true
响应
200 - application/json
公司扩张摘要数组，每个元素对应一家公司。包含两个分数：顶层 expansion_score 为跨所有市场的整体当前态势（稳定值）；summary.window_expansion_score 为按所选时间窗口计算的同一指标。二者在此均为 0-100 范围（不同于搜索结果中 0-1 的 stage.expansion_score）。当您的套餐不含员工数时，firmographics 中的 company_size、employees_count 和 company_size_printed 返回 null，并置 is_employees_locked: true。
⌘I