> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # 用户检索 > 在 Pubrio 数据库中搜索符合指定条件（如职位、地点、公司和资历）的人员。 ## OpenAPI ````yaml cn-openapi POST /people/search openapi: 3.0.0 info: description: >- Pubrio API 提供市场扩张情报——实时捕捉企业进入新市场的信号，以及其底层的公司与人员数据。可搜索、查找并丰富账户与联系人信息，并订阅覆盖 200+ 市场、带类型与日期的动向信号。 version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/zh-CN/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/zh-CN/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: 工作区配置信息和使用统计 - name: Enrichment description: 通过详细的 B2B 数据丰富人员和公司记录 - name: Lookalike description: 查找与指定公司相似的公司 - name: Search description: 使用筛选条件搜索人员、公司、职位、新闻和广告 - name: Lookup description: 查找特定人员、公司、职位、新闻、广告和技术的详细信息 - name: LinkedIn description: 通过 LinkedIn 个人资料 URL 查找人员和公司数据 - name: Redeem description: 兑换积分以解锁人员联系方式（单个和批量） - name: Channels description: 管理外展渠道模板（创建、更新、删除、列表） - name: Monitor description: 创建和管理数据监控，包括 Webhook、统计和处理 - name: Filters description: 获取搜索参数的可用筛选值（技术、地点、垂直领域等） - name: API Keys description: 查看 API 密钥的请求日志和使用情况分析 - name: Insights description: 公司的信号聚合洞察(招聘、新闻、广告)。 - name: Export description: 批量数据导出(消耗积分)。 - name: Expansion description: 公司市场扩张情报:信号、阶段、市场与导出。 externalDocs: description: Pubrio API 用于搜索、预览和增强联系人及账户信息。Pubrio 数据库提供丰富的 B2B 联系人和销售情报数据。 url: https://docs.pubrio.com paths: /people/search: post: tags: - Search summary: 搜索人员 description: 在 Pubrio 数据库中搜索符合指定条件（如职位、地点、公司和资历）的人员。 operationId: people_search parameters: [] requestBody: required: true content: application/json: schema: type: object properties: search_term: $ref: '#/components/schemas/search_term' people_name: $ref: '#/components/schemas/people_name' people_titles: $ref: '#/components/schemas/people_titles' peoples: $ref: '#/components/schemas/peoples' management_levels: $ref: '#/components/schemas/management_levels' departments: $ref: '#/components/schemas/departments' department_functions: $ref: '#/components/schemas/functions' employees: $ref: '#/components/schemas/employees' people_locations: $ref: '#/components/schemas/people_locations' company_locations: $ref: '#/components/schemas/company_locations' company_linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' linkedin_urls: $ref: '#/components/schemas/people_linkedin_urls' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' company_filters: $ref: '#/components/schemas/company_filters' filter_conditions: $ref: '#/components/schemas/people_filter_conditions' is_enable_similarity_search: $ref: '#/components/schemas/is_enable_similarity_search' similarity_score: $ref: '#/components/schemas/similarity_score' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' query: type: string example: decision makers in marketing description: >- 自然语言搜索。提供后，Pubrio 会将其解析为下方的人员和公司筛选条件（职位、职级、部门、地区、行业、公司规模等）。您同时传入的显式筛选条件将优先于解析结果。留空则仅按结构化筛选条件搜索。 is_include_similar_people_titles: type: boolean description: >- 启用后，`people_titles` 除精确匹配外，还会匹配相近的职位名称（例如 `software engineer` 可匹配 `senior software engineer`）。 people_title_similarity_score: type: number format: float example: 0.9 description: >- 与 `is_include_similar_people_titles` 配合使用。控制职位名称需要多接近才算匹配，数值越高，匹配越严格。 profile_id: $ref: '#/components/schemas/profile_id' responses: '200': description: 包含相关详细信息的成功响应。 content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/data' example: metadata: filters: management_levels: - c_suite profile: null data: pagination: page: 1 per_page: 25 total_entries: 199616132 total_pages: 100 total_display_pages: 100 is_timeout: false peoples: - people_search_id: 134591fb-f0fa-41ba-9c8c-f1eb8aab8946 name: Doug McMillon first_name: Doug last_name: McMillon title: President & CEO seniority: c_suite functions: null headline: President & CEO at Walmart Inc. tagline: null introduction: null description: null departments: - c_suite subdepartments: - executive keywords: null employment_history: - title: President & CEO current: true end_date: null start_date: '2014-02-01' company_name: Walmart - title: President & CEO, Walmart International current: false end_date: '2014-01-01' start_date: '2009-02-01' company_name: Walmart - title: President & CEO current: false end_date: '2009-01-01' start_date: '2005-08-01' company_name: Sam's Club country: United States country_code: US location: United States state: Arkansas city: Bentonville wantedly_name: null rocketpunch_name: null contacts: null contact_types: [] emails: null phones: null facebook_url: null github_url: null twitter_url: null linkedin_url: http://www.linkedin.com/in/dougmcmillon wantedly_url: null rocketpunch_url: null saved_lists: null sequences: null social_metadata: {} company: company_name: Walmart company_url: http://walmart.com is_company_url_active: true domain: walmart.com domain_id: 26067151 domain_ids: - 757023267 - 368242703 - 26067151 domain_search_id: 2a0d6cd7-cc10-44d6-94ec-41fd528a11b6 founded_year: 1962 country: United States country_code: US location: United States phones: null emails: [] contacts: [] wantedly_name: null rocketpunch_name: null tiktok_name: null company_size_printed: 466,000 company_size: 466000 industry: Retail specialties: - Retail - E-commerce logo_url: >- https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg linkedin_url: http://www.linkedin.com/company/walmart facebook_url: http://facebook.com/walmart twitter_url: https://twitter.com/walmart crunchbase_url: null instagram_url: http://instagram.com/walmart youtube_url: http://youtube.com/user/walmart x_url: null github_url: null tiktok_url: null wantedly_url: null rocketpunch_url: null social_metadata: {} - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: search_term: type: string example: pubrio description: 用于筛选结果的关键词字符串。 people_name: type: string example: king description: 筛选搜索结果，仅包含指定用戶姓名。 people_titles: type: array items: type: string example: - sales manager - marketing manager description: >- 与目标人员相关的职位名称。 结果还将包含包含类似术语的职位，即使不完全匹配。例如，搜索 `software engineer` 也可能返回职位为 `senior software engineer` 的人员。 peoples: type: array items: type: string format: uuid description: 用于用戶检索操作的一组唯一标识符（people_search_id）列表。 management_levels: type: array items: type: string example: - head description: |- 人员在当前组织中所处的管理层级。可用于定位目前处于特定汇报层级（如C级或高级）的人员。 更多信息请参见筛选器标签下的 `management level` 端点。 departments: type: array items: type: string example: - master_human_resources description: |- 部门字段可用于搜索特定专业领域的人员。 更多信息请参见筛选器标签下的 `department` 端点。 functions: type: array items: type: string example: - human_resources description: |- 职位职能筛选字段可在搜索人员时指定特定岗位或专业领域。 更多信息请参见筛选器标签下的 `department functions` 端点。 employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: |- 公司员工人数范围。可根据员工总数筛选公司，并可添加多个范围以扩展搜索结果。 更多信息请参见筛选器标签下的 `company size` 端点。 people_locations: type: array items: type: string example: - US - SG - CN description: 用戶地点。更多信息请参见筛选器标签下的 `location` 端点。 company_locations: type: array items: type: string example: - US - SG - CN description: 公司总部所在地。更多信息请参见筛选器标签下的 `location` 端点。 company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: LinkedIn 公司主页的完整 URL。URL 需以 `http` 开头且包含 `linkedin.com/company/`。 people_linkedin_urls: type: array items: type: string example: - http://www.linkedin.com/in/king-lai-605382b7 description: >- LinkedIn 用户主页的完整 URL。URL 需以 `http` 开头且包含 `linkedin.com/in/` 或 `linkedin.com/pub/`。 companies: type: array items: type: string format: uuid description: 用于公司和人员检索操作的一组唯一标识符（domain_search_id）列表。 domains: type: array items: type: string example: - pubrio.com description: >- 用于公司和人员检索操作的公司域名列表。如果收到的地址为 `www.pubrio.com` 或 `https://docs.pubrio.com/`，系统会自动转换为 `pubrio.com` 进行处理。 company_filters: type: object description: >- 公司级筛选器的包装对象。推荐分组方式 — 视觉上分开哪些键筛选*人员*(顶层)、哪些筛选*公司*。接受与顶层公司筛选器相同的键(如 `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` 结构一致。示例见筛选器概览开发者指南。 example: company_locations: - US technologies: - 37 - 152 founded_dates: - 2015 - 2023 filter_conditions: - key: technologies operator: and people_filter_conditions: type: array items: type: object properties: key: type: string enum: - keywords - verticals - vertical_categories - vertical_sub_categories - technologies - categories - places - exclude_places - social_media example: technologies description: 要应用运算符的筛选键。键名引用统一公司筛选的名称(使用 `places`,而不是 `company_places`)。 operator: type: string enum: - or - and example: and description: 要应用的逻辑运算符。使用 'or' 匹配任何指定值,或使用 'and' 要求匹配所有指定值。 description: /people/search 中的按键 AND/OR 覆盖。省略时默认为 OR。完整的键重映射参考请见“人员 + 公司筛选器”开发者指南。 is_enable_similarity_search: type: boolean description: 启用后，上述支持相似度搜索的筛选器可直接填写自由文本以检索特定ID。 similarity_score: type: number format: float example: 0.7 description: >- 需与 `is_enable_similarity_search` 配合使用。该数值用于分析特定 slug（如行业、技术）与用户输入的相似程度，数值越高，匹配越严格。 per_page: type: integer example: 25 description: 每页应返回的搜索结果数量。限制每页结果数量可提升接口性能。 page: type: integer example: 1 description: 要检索的数据页码。 profile_id: type: integer description: >- 可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID 有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。 更多信息请参见团队标签下的 `user details` 端点。 data: type: object nullable: true description: 响应信息取决于具体接口。 responses: general_error: description: 请求错误。请求格式不正确或包含无效参数。请检查错误代码和消息以获取详细信息。 content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: 错误及代码会根据不同场景有所不同，详情请参阅文档。 type: string details: type: object rate_limit_error: description: 超出速率限制。在给定时间段内发送了过多请求。请在速率限制窗口重置后重试。 content: application/json: schema: required: - error type: object properties: error: example: 请求频率超出限制。请稍后再试。 type: string server_error: description: 内部服务器错误。服务器发生意外错误。如果错误持续存在，请联系支持团队。 content: application/json: schema: required: - error type: object properties: error: example: 服务器在处理请求时遇到了未预料的异常。 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- 一个唯一的 API 令牌，用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在 [设置](https://dashboard.pubrio.com/#/settings/) 部分创建该令牌。 in: header ````