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

每页记录数。默认 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

响应

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

metadata
object

请求上下文:recent_search_log_identifier、回显的 parametersfilters,以及带有 credittopup_credittotal_credit_costprofile 区块。

data
object | null

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