---
title: "语义搜索 OPC 产品"
method: GET
path: "/v1/search/products"
tags: ["检索"]
---

# 语义搜索 OPC 产品

`GET /v1/search/products`

## Request

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

用户用自然语言找产品时调用，例如「有没有给独立开发者用的财务工具」「记笔记的极简 app」「Notion 替代品」。 先走向量召回（embedding），召回不到再 fallback 到关键词。返回按相关度排序的产品卡片。 注意：本接口只管产品；找主理人 / 找人合作用 searchPeople。 「什么是独行录」「如何注册」这类站点 meta 问题也不要用本接口。

## Query parameters

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

## Response `200`

检索结果

- object
  - `ok` boolean
  - `data` object
    - `results` ProductSearchHit[]
      - `id` string: 产品 id（可传给 getProduct）
      - `slug` string
      - `name` string
      - `tagline` string: 一句话简介
      - `category` string: 类型：APP / WEBSITE / 其他
      - `similarity` number: 相关度 0-1
      - `claimed` boolean: 是否已被主理人认领
      - `via` string: 命中方式：name / both / vector / keyword
    - `mode` 'hybrid' | 'vector' | 'keyword': 实际走的检索路径
    - `reranked` boolean

---

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