---
title: "搜需求（标题/详情，关键词 + 语义混合）"
method: GET
path: "/v1/search/needs"
tags: ["需求互换"]
---

# 搜需求（标题/详情，关键词 + 语义混合）

`GET /v1/search/needs`

## Request

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

带意图地找需求，例如「有没有人在找播客合作」「谁需要供应链资源」「找人合作做线下市集」。 关键词与语义向量融合召回，按相关度排序。与 listNeedsFeed（逛）互补：feed 适合无明确意图浏览， 本接口适合精确命中。结果与 feed 同一卡片契约，可直接接 getNeed 或 searchPeople 继续。

## Query parameters

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

## Response `200`

需求检索结果（按相关度排序）

- object
  - `ok` boolean
  - `data` object
    - `results` NeedCard[]
      - `id` string
      - `type` 'EXPERIENCE' | 'QA' | 'RESOURCE' | 'COLLAB' | 'FINANCING' | 'CHAT' | 'OTHER': 需求类型：EXPERIENCE=寻找产品/作品；QA=答疑求助；RESOURCE=介绍资源； COLLAB=寻求合作；FINANCING=融资需求；CHAT=找人聊聊找灵感；OTHER=其它。
      - `title` string
      - `detail` string, nullable: 需求详情
      - `completionNote` string, nullable: 完成条件说明
      - `images` string[]: 配图 URL 列表
      - `status` 'OPEN' | 'IN_PROGRESS' | 'COMPLETED' | 'CANCELLED' | 'EXPIRED': 需求状态（OPEN/IN_PROGRESS 会出现在 feed；被承接也继续展示）
      - `createdAt` string, date-time
      - `author` NeedAuthor: 需求作者：canOffer + 代表产品，判断「他能给什么」
        - `id` string
        - `nickname` string
        - `avatarUrl` string, nullable
        - `isVerified` boolean
        - `canOffer` string, nullable: 作者能提供什么价值
        - `products` object[]: 代表产品（最多 1 个；有产品=主理人，无=观众）
          - `id` string
          - `slug` string
          - `name` string
          - `tagline` string
          - `logoUrl` string, nullable

---

[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)