搜索相似公司 - Pubrio Documentation

curl --request POST \ --url https://api.pubrio.com/companies/search/similar \ --header 'Content-Type: application/json' \ --header 'pubrio-api-key: <api-key>' \ --data ' { "company_name": "pubrio", "companies": [ "3c90c3cc-0d44-4b50-8888-8dd25736052a" ], "domains": [ "pubrio.com" ], "linkedin_urls": [ "https://www.linkedin.com/company/pubrio" ], "company_filters": { "company_locations": [ "US" ], "technologies": [ 37, 152 ], "founded_dates": [ 2015, 2023 ], "filter_conditions": [ { "key": "technologies", "operator": "and" } ] }, "locations": [ "US", "SG", "CN" ], "exclude_locations": [ "CN", "US", "RU", "CA" ], "places": [ "Tokyo" ], "exclude_places": [ "Tokyo" ], "job_locations": [ "US", "SG", "CN" ], "job_exclude_locations": [ "CN", "US", "RU", "CA" ], "job_posted_dates": [ "2025-01-01", "2025-01-10" ], "job_titles": [ "sales manager", "marketing manager" ], "verticals": [ 123 ], "vertical_categories": [ 123 ], "vertical_sub_categories": [ 123 ], "categories": [ 123 ], "technologies": [ 123 ], "employees": [ [ 1, 10 ], [ 11, 20 ], [ 10001 ] ], "revenues": [ 0, 100000 ], "founded_dates": [ 2018, 2024 ], "keywords": [ "ecommerce", "ai", "fintech" ], "news_categories": [ "launches" ], "news_published_dates": [ "2025-01-01", "2025-01-10" ], "advertisement_search_terms": [ "asus" ], "advertisement_target_locations": [ "TW", "AE", "NO" ], "advertisement_exclude_target_locations": [ "IS", "GB", "FR", "IE", "ES" ], "advertisement_start_dates": [ "2025-12-25", "2025-12-25" ], "advertisement_end_dates": [ "2025-12-25", "2025-12-25" ], "filter_conditions": [ { "key": "keywords", "operator": "or" } ], "is_enable_similarity_search": true, "similarity_score": 0.7, "exclude_fields": [ "emails", "phones", "contacts" ], "is_parameter_metadata_available": true, "is_profile_metadata_available": true, "per_page": 25, "page": 1, "profile_id": 123 } '

{ "data": { "pagination": { "page": 1, "per_page": 25, "total_entries": 45234700, "total_pages": 1809388 }, "companies": [ { "logo_url": "https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg", "company_name": "Twitter", "emails": [ "..." ], "phones": [ "..." ], "contacts": [ "..." ], "founded_year": 2006, "specialties": [ "Software Development" ], "industry": "Software Development", "domain": "twitter.com", "domain_search_id": "61a73da7-2efc-41a5-a252-a8a8df29925a", "domain_id": 224475931, "linkedin_company_id": 44005587, "linkedin_name": "twitter", "is_company_url_active": true, "domain_ids": [ 224475931, 1758889566, 368242865 ], "company_keywords": [ "realtime information", "social commerce", "online shopping", "classifieds", "craigslist killers", "e-commerce", "killers", "consumer internet", "internet", "information technology", "edp services", "technology", "software development", "microblogging", "social networking", "public conversation", "user engagement", "content sharing", "advertising solutions", "monetization", "community building", "digital wallet", "ai integration", "user safety" ], "company_size": 1500, "youtube_url": null, "crunchbase_url": null, "linkedin_url": "http://www.linkedin.com/company/twitter", "instagram_url": null, "facebook_url": "http://facebook.com/twitterinc", "twitter_url": "https://twitter.com/x", "github_url": null, "x_url": null, "location": "United States", "company_ranking": null, "company_url": "http://twitter.com", "saved_lists": null, "company_size_printed": "1,500", "similarity_score": 0.87 }, "..." ] } }

授权

pubrio-api-key

string

header

必填

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

请求体

application/json

company_name

string

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

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

示例:

"pubrio"

companies

string<uuid>[]

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

domains

string[]

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

示例:

["pubrio.com"]

linkedin_urls

string[]

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

示例:

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

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 结构一致。示例见筛选器概览开发者指南。

示例:

{
  "company_locations": ["US"],
  "technologies": [37, 152],
  "founded_dates": [2015, 2023],
  "filter_conditions": [
    { "key": "technologies", "operator": "and" }
  ]
}

locations

string[]

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

示例:

["US", "SG", "CN"]

exclude_locations

string[]

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

示例:

["CN", "US", "RU", "CA"]

places

string[]

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

示例:

["Tokyo"]

exclude_places

string[]

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

示例:

["Tokyo"]

job_locations

string[]

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

示例:

["US", "SG", "CN"]

job_exclude_locations

string[]

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

示例:

["CN", "US", "RU", "CA"]

job_posted_dates

string[]

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

示例:

["2025-01-01", "2025-01-10"]

job_titles

string[]

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

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

示例:

["sales manager", "marketing manager"]

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 端点。

示例:

[[1, 10], [11, 20], [10001]]

revenues

integer[]

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

示例:

[0, 100000]

founded_dates

integer[]

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

示例:

[2018, 2024]

keywords

string[]

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

示例:

["ecommerce", "ai", "fintech"]

news_categories

string[]

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

示例:

["launches"]

news_published_dates

string[]

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

示例:

["2025-01-01", "2025-01-10"]

advertisement_search_terms

string[]

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

示例:

["asus"]

advertisement_target_locations

string[]

广告的目标地理位置。

示例:

["TW", "AE", "NO"]

advertisement_exclude_target_locations

string[]

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

示例:

["IS", "GB", "FR", "IE", "ES"]

advertisement_start_dates

string<date>[]

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

示例:

["2025-12-25", "2025-12-25"]

advertisement_end_dates

string<date>[]

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

示例:

["2025-12-25", "2025-12-25"]

filter_conditions

object[]

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

Show child attributes

is_enable_similarity_search

boolean

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

similarity_score

number<float>

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

示例:

0.7

exclude_fields

string[]

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

示例:

["emails", "phones", "contacts"]

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

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

API 文档

端点

授权

请求体

响应