---
title: "关键词检索零部件"
method: GET
path: "/api/search"
tags: ["Data"]
---

# 关键词检索零部件

`GET /api/search`

## Request

- Base URL: `https://roboparts.cc`
- URL: `https://roboparts.cc/api/search`
- Auth: none declared

按关键词检索实体。多个词以空格分隔，按全部命中(AND)匹配；结果按字段加权排序（id>名称>厂商>类型>应用/接口>描述）。这是字面匹配，不是语义检索。默认排除已标记 quarantine 的可疑条目，并在 meta 中报明排除条数。付费字段不参与匹配也不返回。

## Query parameters

- `q` string, required
- `category` string
- `limit` integer
- `include_quarantine` boolean

## Response `200`

命中结果（含 relevance_score / matched_fields / detail_url）

## Other responses

- `400`: 缺少 q 或品类不存在
- `503`: 实体库不可用；刻意不降级为空结果，避免把故障伪装成「没搜到」

---

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