Skip to main content
POST
搜索公司

授权

pubrio-api-key
string
header
必填

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

请求体

application/json
company_name
string

筛选搜索结果,仅包含指定公司名称。

如果输入的值与公司名称不匹配,则该公司不会出现在搜索结果中,即使其他参数匹配也不会。支持部分匹配。

示例:

"pubrio"

companies
string<uuid>[]

用于公司和人员检索操作的一组唯一标识符(domain_search_id)列表。

company_groups
integer[]

仅返回这些公司分组(ID)中的成员,例如监控的 source_group_id 或 excluded_group_id;与其他搜索一样分页。

domains
string[]

用于公司和人员检索操作的公司域名列表。如果收到的地址为 www.pubrio.com 或 https://docs.pubrio.com/,系统会自动转换为 pubrio.com 进行处理。

示例:
linkedin_urls
string[]

LinkedIn 公司主页的完整 URL。URL 需以 http 开头且包含 linkedin.com/company/。

示例:
company_filters
object

公司级筛选器的包装对象。推荐分组方式 — 视觉上分开哪些键筛选人员(顶层)、哪些筛选公司。接受与顶层公司筛选器相同的键(如 technologies、verticals、vertical_categories、vertical_sub_categories、categories、keywords、founded_dates、employees、revenues、company_locations、company_exclude_locations、company_places、company_exclude_places、companies、domains、company_linkedin_urls、is_enable_similarity_search、similarity_score,以及 filter_conditions)。引擎在处理前会把此对象摊平到顶层 — 同名时顶层键优先。与 Monitor company_filters 结构一致。示例见筛选器概览开发者指南。

示例:
locations
string[]

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

示例:
exclude_locations
string[]

ISO 3166-1 alpha-2(cca2)用于筛选不需要返回的地区。更多信息请参见筛选器标签下的 location 端点。

示例:
places
string[]

用于筛选结果的地点名称(城市或地区)。接受本地化或英文地点名称。

示例:
exclude_places
string[]

要从结果中排除的地点名称(城市或地区)。接受本地化或英文地点名称。

示例:
job_locations
string[]

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

示例:
job_exclude_locations
string[]

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

示例:
job_posted_dates
string[]

发布日期的时间范围。最大值为当天。 日期边界遵循你的工作区时区。

示例:
job_titles
string[]

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

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

示例:
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"]。

categories
integer[]

category_id 列表,用于搜索公司所用的特定技术类别。要获取ID,请调用筛选器标签下的 category 端点。

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

technologies
integer[]

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

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

技术列表中已有的产品名称会匹配该产品及其自有产品("Salesforce" 也会匹配 Salesforce Desk 和 Salesforce Service Cloud),不会匹配相似的其他产品;其他文本按相似度匹配。

exclude_technologies
string[]

公司不得使用的技术,填写 tag_id,或在启用 is_enable_similarity_search 时填写名称,例如 ["Shopify"]。没有已知技术的公司会保留。

示例:
employees
string[][]

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

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

示例:
revenues
integer[]

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

示例:
founded_dates
integer[]

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

示例:
keywords
string[]

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

示例:
social_media
enum<string>[]

在以下任一网络拥有主页的公司:linkedin、facebook、instagram、tiktok、twitter、x、github、wantedly、rocketpunch。可用 filter_conditions 提升为 AND。

可用选项:
linkedin,
facebook,
instagram,
tiktok,
twitter,
x,
github,
wantedly,
rocketpunch
示例:
news_categories
string[]

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

示例:
news_published_dates
string[]

发布时间的时间范围。最大值为当天。 日期边界遵循你的工作区时区。

示例:
advertisement_search_terms
string[]

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

示例:
advertisement_target_locations
string[]

广告的目标地理位置。

示例:
advertisement_exclude_target_locations
string[]

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

示例:
advertisement_start_dates
string<date>[]

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

示例:
advertisement_end_dates
string<date>[]

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

示例:
advertisement_active_dates
string<date>[]

查找在此日期范围内任意时间点仍处于投放状态的广告(基于重叠判定:包含在该范围开始前就已投放、且持续至今仍在投放的广告,而不仅是在范围内才开始投放的广告)。

示例:
advertisement_status
enum<string>[]

currently_running:有广告记录的公司。active_last_30_min:广告在最近 30 分钟内有变化的公司。

可用选项:
currently_running,
active_last_30_min
示例:
advertisement_headlines
string[]

用于在广告标题文本中搜索的关键词。

示例:
advertisement_platforms
enum<string>[]

按投放广告所来源的广告库进行筛选。使用小写,且不区分大小写。meta 可作为 facebook 的别名使用。

可用选项:
linkedin,
facebook,
google,
tiktok,
apple
示例:
advertisement_publisher_platforms
enum<string>[]

按投放的平台版位筛选 Facebook/Meta 广告。使用小写,且不区分大小写。仅适用于 facebook 来源(其他来源为单一平台)。

可用选项:
facebook,
instagram,
messenger,
threads,
audience_network
示例:
advertisement_exclude_publisher_platforms
enum<string>[]

排除在这些平台版位投放的 Facebook/Meta 广告。

可用选项:
facebook,
instagram,
messenger,
threads,
audience_network
示例:
advertisement_formats
enum<string>[]

查找至少有一条广告采用以下任一创意形式的公司。

可用选项:
image,
video,
text,
carousel,
dynamic_product,
document,
message,
event,
article,
spotlight,
follow,
job,
engagement
示例:
advertisement_active_ads
(integer | null)[]

公司当前活跃广告数量的最小值和最大值,统计范围为所有国家。使用 null 表示开放边界,例如 [1, null] 表示"至少一条活跃广告"。

Required array length: 2 elements
示例:
advertisement_running_ads
(integer | null)[]

公司仍在投放中的广告数量的最小值和最大值(无结束日期,或结束日期在未来)。目前仅针对 LinkedIn 广告填充此数据。

Required array length: 2 elements
示例:
advertisement_total_ads
(integer | null)[]

公司有记录以来的广告总数的最小值和最大值,统计范围为所有国家。

Required array length: 2 elements
示例:
advertisement_platform_count
(integer | null)[]

公司当前正在投放广告的不同广告平台(linkedin、facebook、google、tiktok、apple)数量的最小值和最大值。

Required array length: 2 elements
示例:
advertisement_format_count
(integer | null)[]

公司当前正在投放的不同广告创意形式数量的最小值和最大值。

Required array length: 2 elements
示例:
advertisement_impressions_estimate
(integer | null)[]

预估广告展示次数的最小值和最大值,为所有国家的总和。仅统计具有已报告展示次数区间的广告。

Required array length: 2 elements
示例:
advertisement_country_activity
object

特定国家的广告投放活动。country 为必填项,且必须至少设置一个其他字段(仅提供国家本身不会匹配任何结果)。若需要所有国家的汇总数据,请改用顶层的 advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate 筛选器。

示例:
sort_by
enum<string>

结果排序方式。留空则使用默认的相关性排序。advertisement_country_rank 会按公司在 advertisement_country_activity 所指定国家内的广告排名排序(排名 1 = 该市场投放量最大的广告主),未使用该筛选器时此排序会被忽略。搭配 is_ascending_order: false 可让投放量最小的广告主排在最前。 暂不支持:name(升序和降序均不支持)以及配合 is_ascending_order: false 的 relevance —— 这些请求会超时。请改用默认的相关性排序、number_of_employees 或 founded_year。

可用选项:
relevance,
name,
number_of_employees,
founded_year,
advertisement_country_rank
示例:

"advertisement_country_rank"

is_ascending_order
boolean

sort_by 的排序方向。默认为升序,对 advertisement_country_rank 而言即投放量最大的广告主排在最前。

示例:

true

filter_conditions
object[]

公司搜索的高级筛选选项。指定结合键与逻辑运算符的条件以优化搜索结果。

启用后,上述支持相似度搜索的筛选器可直接填写自由文本以检索特定ID。

similarity_score
number<float>

需与 is_enable_similarity_search 配合使用。该数值用于分析特定 slug(如行业、技术)与用户输入的相似程度,数值越高,匹配越严格。

示例:

0.7

query
string

自然语言搜索。提供后,Pubrio 会将其解析为下方的公司筛选条件:行业(及要排除的行业)、细分领域、技术(及不使用的技术)、社交媒体主页、总部所在国家、地区或城市、员工人数、营收、成立年份、正在招聘的职位及地点、新闻事件(如“最近扩张”)、广告(平台、形式、投放国家、广告数量、曝光量、日期、在某一国家的排名)以及云托管(服务商、服务器所在国家和城市、主机与服务器数量,整体或某一国家)。用“或”连接的值匹配其中任意一个;用“和”连接的工具或主页(“同时使用 Salesforce 和 HubSpot”)必须全部匹配。你同时传入的显式筛选条件优先于解析结果。句子中无法用任何筛选条件表达的部分(例如所有权)会在 metadata.unmatched_criteria 中返回,而不会被丢弃;没有可搜索内容的句子将返回空结果,并带有 metadata.nl_no_intent: true。

示例:

"Food & Beverage companies in Singapore that recently expanded"

exclude_fields
string[]

要从响应中排除的字段列表。

示例:
is_parameter_metadata_available
boolean

指示请求中是否可用参数元数据。

is_profile_metadata_available
boolean

指示请求中是否可用配置文件元数据。

per_page
integer
默认值:25

每页记录数。默认 25,在大多数套餐下这也是上限 —— 该限制即订阅中的 max_search_per_page,可通过 Profile 获取。超出会返回 HTTP 416 及错误码 41676(公司与人物搜索为 41613),而不是自动截断结果。

必填范围: x <= 25
示例:

25

page
integer
默认值:1

页码,从 1 开始。上限为订阅中的 max_search_page(公司搜索为 max_company_search_page),可通过 Profile 获取。超出会返回 HTTP 416。

示例:

1

cloud_footprint_providers
string[]

筛选在任意位置使用这些服务商的公司。不带前缀的 providers 缩小返回的记录;此项缩小公司范围。

示例:
cloud_footprint_exclude_providers
string[]

排除匹配这些云或托管服务商的足迹记录。 仅限该条足迹记录 — 一个服务商、一个国家。

示例:
cloud_footprint_target_locations
string[]

在其足迹中任意位置出现在这些国家的公司。

示例:
cloud_footprint_exclude_target_locations
string[]

排除匹配这些基础设施所在的国家代码的足迹记录。

示例:
cloud_footprint_cloud_regions
string[]

仅返回匹配这些云区域的足迹记录。 仅限该条足迹记录 — 一个服务商、一个国家。

示例:
cloud_footprint_exclude_cloud_regions
string[]

排除匹配这些云区域的足迹记录。 仅限该条足迹记录 — 一个服务商、一个国家。

示例:
cloud_footprint_cities
string[]

仅返回匹配这些城市的足迹记录。 仅限该条足迹记录 — 一个服务商、一个国家。

示例:
cloud_footprint_exclude_cities
string[]

排除匹配这些城市的足迹记录。 仅限该条足迹记录 — 一个服务商、一个国家。

示例:
cloud_footprint_first_seen_dates
(string | null)[]

两个 ISO 8601 日期(YYYY-MM-DD),限定足迹首次发现的时间范围。 仅限该条足迹记录 — 一个服务商、一个国家。

Required array length: 2 elements
示例:
cloud_footprint_last_seen_dates
(string | null)[]

两个 ISO 8601 日期(YYYY-MM-DD),限定足迹最近发现的时间范围。 仅限该条足迹记录 — 一个服务商、一个国家。

Required array length: 2 elements
示例:
cloud_footprint_is_cross_border_only
boolean

为 true 时仅返回公司本土市场以外的足迹记录。总部未知的公司记录会被排除。

示例:

true

cloud_footprint_host_count
(integer | null)[]

主机数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计,涵盖所有服务商与国家。

Required array length: 2 elements
示例:
cloud_footprint_server_count
(integer | null)[]

服务器数(不同 IP)的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计,涵盖所有服务商与国家。

Required array length: 2 elements
示例:
cloud_footprint_shared_server_count
(integer | null)[]

与其他公司共用的服务器数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计,涵盖所有服务商与国家。

Required array length: 2 elements
示例:
cloud_footprint_provider_count
(integer | null)[]

公司使用的不同服务商数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计,涵盖所有服务商与国家。

Required array length: 2 elements
示例:
cloud_footprint_country_count
(integer | null)[]

公司托管所在的国家数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计,涵盖所有服务商与国家。

Required array length: 2 elements
示例:
cloud_footprint_cross_border_country_count
(integer | null)[]

本土市场以外的国家数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计,涵盖所有服务商与国家。

Required array length: 2 elements
示例:
cloud_footprint_region_count
(integer | null)[]

云区域数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计,涵盖所有服务商与国家。

Required array length: 2 elements
示例:
cloud_footprint_city_count
(integer | null)[]

城市数的最小值与最大值。使用 null 表示不设该端边界。 按公司整体统计,涵盖所有服务商与国家。

Required array length: 2 elements
示例:
cloud_footprint_primary_provider
string[]

主要(占比最大)服务商为其中之一的公司。

示例:
cloud_footprint_country_activity
object

限定单一国家的范围条件:{"country":"DE","host_count":[100,null]} 查找在德国运行 100 台以上主机的公司。不带此结构的 cloud_footprint_host_count 是公司在所有国家的总量,二者无法组合表达。仅提供 country 会被拒绝。

响应

包含相关详细信息的成功响应。

metadata
object

请求上下文:recent_search_log_identifier、回显的 parameters 和 filters、可选的 profile 额度块,以及 ignored_fields(端点丢弃的请求键)。

data
object | null

响应信息取决于具体接口。

最后修改于 2025年6月9日