Skip to main content
POST
搜索相似公司

授权

pubrio-api-key
string
header
必填

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

请求体

application/json
company_name
string

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

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

示例:

"pubrio"

companies
string<uuid>[]

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

domains
string[]

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

示例:
linkedin_urls
string[]

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

示例:
company_filters
object

公司级筛选器的包装对象。推荐分组方式 — 视觉上分开哪些键筛选人员(顶层)、哪些筛选公司。接受与顶层公司筛选器相同的键(如 technologiesverticalsvertical_categoriesvertical_sub_categoriescategorieskeywordsfounded_datesemployeesrevenuescompany_locationscompany_exclude_locationscompany_placescompany_exclude_placescompaniesdomainscompany_linkedin_urlsis_enable_similarity_searchsimilarity_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"]

employees
string[][]

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

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

示例:
revenues
integer[]

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

示例:
founded_dates
integer[]

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

示例:
keywords
string[]

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

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

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

示例:
filter_conditions
object[]

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

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

similarity_score
number<float>

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

示例:

0.7

exclude_fields
string[]

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

示例:
is_parameter_metadata_available
boolean

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

is_profile_metadata_available
boolean

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

per_page
integer

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

示例:

25

page
integer

要检索的数据页码。

示例:

1

profile_id
integer

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

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

响应

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

data
object | null

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