> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 人物搜索

> 使用 Business Search 查找人物。[POST /search/people](/cn/api-reference/business-search/search-people) 可按职位、当前公司、地点和关注者数量搜索，支持结构化条件或自然语言。

人物搜索用于识别目标客户中的采购决策者，或为某个职位建立人才库。

所有人物请求都发送到 [`POST /search/people`](/cn/api-reference/business-search/search-people)。

## 应该使用哪些人物字段名

字段接受哪些运算符取决于字段类型。文本类型字段只接受 `text` 运算符；字符串、整数等有类型字段接受 `equals`、`in` 和 `range`。对文本字段使用 `equals` 会返回 HTTP 400。

| 字段                         | 类型  | 运算符           | 说明                                                                                                                                                                                                 |
| -------------------------- | --- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `current_title`            | 文本  | `text`        | 用 `mode: "all"` 要求每个词都命中                                                                                                                                                                           |
| `all_text`                 | 文本  | `text`        | 同时搜索职位、角色和简介                                                                                                                                                                                       |
| `name`                     | 文本  | `text`        |                                                                                                                                                                                                    |
| `about`                    | 文本  | `text`        |                                                                                                                                                                                                    |
| `location`                 | 文本  | `text`        | 描述性地点字符串                                                                                                                                                                                           |
| `current_company_name`     | 文本  | `text`        |                                                                                                                                                                                                    |
| `current_company_industry` | 文本  | `text`        |                                                                                                                                                                                                    |
| `past_job_titles`          | 文本  | `text`        |                                                                                                                                                                                                    |
| `role`、`company`、`skill`   | 文本  | `text`        | 每个都同时搜索一组字段：`role` 覆盖 `current_title`、`past_job_titles` 和 `about`；`company` 覆盖 `current_company_industry`、`specialties`、`description`、`slogan` 和 `name`；`skill` 覆盖 `about` 和 `certification_names` |
| `city`                     | 字符串 | `equals`、`in` | 精确城市名                                                                                                                                                                                              |
| `country_code`             | 字符串 | `equals`、`in` | ISO 3166 alpha-2 代码，例如 `US` 或 `GB`                                                                                                                                                                 |
| `followers`                | 整数  | `range`       |                                                                                                                                                                                                    |

## 人物搜索请求长什么样

以下 Ludicrous 请求查找当前职位同时包含 `product` 和 `manager`、关注者不少于 1,000 的美国档案：

```json theme={null}
{
  "mode": "ludicrous",
  "query": {
    "and": [
      {
        "text": {
          "current_title": { "value": "product manager", "mode": "all" }
        }
      },
      { "equals": { "country_code": "US" } },
      { "range": { "followers": { ">=": 1000 } } }
    ]
  },
  "offset": 0,
  "limit": 10,
  "view": {
    "fields": [
      "name", "current_title", "current_company_name",
      "location", "followers", "url"
    ]
  }
}
```

`text` 条件中的 `mode: "all"` 要求每个搜索词都命中，但这些词不必构成完整短语，因此职位为 “Senior Manager, Product” 的档案同样会匹配。词与词之间的标点不影响匹配，词序不影响匹配，职位中包含额外词语也允许。

## 如何处理缺失的档案字段

部分档案可能缺少地点和雇主字段。字段缺失不代表对应的现实信息不成立。没有 `current_company_name` 的档案只是没有公开雇主，并不意味着此人处于失业状态。

请在不影响整条记录的前提下处理空值或 null，并避免使用会把所有可选字段为空的档案默默剔除的过滤条件。

## summary 视图返回哪些字段

`summary` 视图返回 11 个字段：`name`、`current_title`、`current_company_name`、`current_company_industry`、`location`、`city`、`country_code`、`followers`、`connections`、`url` 和 `avatar`。档案中没有值的字段会被省略，而不是返回 null。

当应用需要特定字段集合时，请请求 `fields` 列表。参见 [Business Search 字段视图](/cn/products/business-search/select-fields)。