---
title: "搜主理人/超级个体（按「能提供什么价值」）"
method: GET
path: "/v1/search/people"
tags: ["检索"]
---

# 搜主理人/超级个体（按「能提供什么价值」）

`GET /v1/search/people`

## Request

- Base URL: `https://api.opcmenu.com`
- URL: `https://api.opcmenu.com/v1/search/people`
- Auth: none declared

混合检索主理人：昵称/简介/「能提供什么价值」关键词 + 语义向量融合。 与 listCreators（热度榜）不同，本接口适合带意图的找人，例如「找能提供供应链资源的主理人」 「懂跨境电商合规的人」。结果卡主打 canOffer（对方能提供什么），真人账号排前。 典型组合链：listNeedsFeed/getNeed 看到一条需求 → searchPeople 找能满足它的人； agent 也可以批量跑多个查询词，替用户做候选人对比表。

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

主理人检索结果（按相关度排序）

- object
  - `ok` boolean
  - `data` object
    - `results` PersonHit[]
      - `id` string: 用户 id（可作 listPosts 的 authorId）
      - `nickname` string, nullable
      - `avatarUrl` string, nullable
      - `bio` string, nullable
      - `canOffer` string, nullable: 能提供什么价值（供给侧自述）
      - `isVerified` boolean
      - `similarity` number: 相关度 0-1
      - `claimed` boolean: 真人账号（true）优先于系统占位
      - `isCloud` boolean: 云用户（还没用独行录 App 的社群成员，只能收合作请求、由独行录人工小秘书转达）。 云用户只对登录用户可搜，本 spec 的匿名检索恒为 false；为 true 时 bio 是「职位 · 公司」。
      - `via` string: 命中方式：name / semantic / both

---

[API](https://skmtc.dev/opcmenu/apis/opc-api.md) · [All operations](https://skmtc.dev/opcmenu/apis/opc-api/llms.txt) · [OpenAPI document](https://skmtc.dev/opcmenu/apis/opc-api/revisions/ccdee07fb248?raw)