Listing 批量筛查 · batch-screen

POST /v1/batch-screen

批量筛查产品标题中夹带的商标:逐条提取品牌词、过滤通用词,给出撞标风险与冲突项。

消耗:20 API 点 / 条(按有效条数计)
可用档位:全部(含免费版)
计费口径:按去掉空条目后的有效条数扣点;单次最多 2,000 条,超过返回 400 且不扣点
检索范围:固定比对美国 USPTO 库,不接收 country 参数

请求参数

参数	类型	必填	说明
`items`	array	是	待筛查条目数组(单次 ≤ 2,000 条)
`items[].title`	string	是	Listing 标题 / 文本
`items[].nice`	string	否	该条尼斯分类(可选)

请求示例

cURL
Python

curl -X POST "https://one1.cn/v1/batch-screen" \
  -H "Authorization: Bearer one1_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"title":"Nike Running Shoes","nice":"25"}]}'

import requests
r = requests.post(
    "https://one1.cn/v1/batch-screen",
    json={"items": [{"title": "Nike Running Shoes", "nice": "25"}]},
    headers={"Authorization": "Bearer one1_live_xxxxxxxx"},
)
print(r.json())

响应示例

{
  "results": [
    { "name": "Nike Running Shoes", "risk": "高", "tro_hit": false, "top_conflict": "NIKE" }
  ],
  "count": 1,
  "coverage": { "scope": "full", "warning": "", "clearance_ok": true },
  "request_id": "3f9a1c2b7d4e8f01",
  "timestamp": "2026-10-10T07:20:01Z"
}

响应字段

字段	类型	说明
`results[].name`	string	原始标题
`results[].risk`	string	风险等级(高/中/低)
`results[].tro_hit`	bool	true = 命中 One1 维护的 TRO 维权高危库;false = 未命中,不等于无维权风险
`results[].top_conflict`	string	最相关冲突商标
`count`	int	条数
`coverage.scope`	string	美国 USPTO 文本库的覆盖口径(本端点固定比对美国库);`coverage.clearance_ok` 为 false 时「低」风险不可当作可注册
`coverage.warning`	string	覆盖警示文案(空串 = 无警示),请原样展示给终端用户;文案来自覆盖度配置,可能提及该库的数据截止时间
`coverage.clearance_ok`	bool	是否可把「无匹配」当作可注册的参考依据;仅 `coverage.scope` 为 `full` 时为 true
`request_id`	string	本次请求的追踪 ID,与响应头 `X-Request-Id` 同值(调用方自带该头则原样回显);排障时请提供
`timestamp`	string	服务端响应时间,UTC ISO 8601 带 `Z`(如 `2026-10-10T07:20:01Z`);不代表数据新鲜度

请求参数​

请求示例​

响应示例​

响应字段​

请求参数

请求示例

响应示例

响应字段