Skip to main content
POST
搜索相似公司

授权

pubrio-api-key
string
header
必填

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

请求体

application/json
domain_search_id
string<uuid>
必填

用于公司检索操作的唯一标识符。

locations
string[]

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

示例:
exclude_locations
string[]

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

示例:
technologies
integer[]

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

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

categories
integer[]

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

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

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"]

domain
string

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

示例:

"pubrio.com"

linkedin_url
string

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

示例:

"https://www.linkedin.com/company/pubrio"

employees
string[][]

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

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

示例:
founded_dates
integer[]

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

示例:
revenues
integer[]

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

示例:
job_locations
string[]

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

示例:
job_posted_dates
string[]

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

示例:
job_titles
string[]

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

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

示例:
news_categories
string[]

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

示例:
news_published_dates
string[]

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

示例:

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

similarity_score
number<float>

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

示例:

0.7

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

请求上下文。包含回显的 filtersparameters,以及带有 credittopup_credittotal_credit_costprofile 区块 —— 这是 API 返回的唯一按次积分核算信息。

data
object | null

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