图形代码检索 · graphic
GET /v1/graphic
按 USPTO 图形检索代码(Design Search Code)与尼斯分类查找图形商标。
- 消耗:30 API 点
- 可用档位:全部(含免费版)
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
design | string | 是 | USPTO 图形检索代码 |
nice | string | 否 | 尼斯分类号 |
live | 0/1 | 否 | 仅有效在册 |
limit | int | 否 | 返回条数上限,默认 100,最大 300 |
请求示例
- cURL
- Python
curl "https://one1.cn/v1/graphic?design=030102&nice=25&live=1&limit=20" \
-H "Authorization: Bearer one1_live_xxxxxxxx"
import requests
r = requests.get(
"https://one1.cn/v1/graphic",
params={"design": "030102", "nice": "25", "live": 1},
headers={"Authorization": "Bearer one1_live_xxxxxxxx"},
)
print(r.json())
响应示例
{
"results": [
{ "serial": "79000000", "mark": "…", "design": "030102", "nice": "25", "is_live": 1 }
],
"count": 1,
"coverage": { "scope": "full", "warning": "", "clearance_ok": true },
"request_id": "3f9a1c2b7d4e8f01",
"timestamp": "2026-10-10T07:20:01Z"
}
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
results[].serial | string | 商标序列号 |
results[].mark | string | 商标文本(如有) |
results[].design | string | 图形检索代码 |
results[].nice | string | 尼斯分类 |
results[].is_live | 0/1 | 是否有效在册 |
count | int | 结果条数 |
coverage.scope | string | 美国库的覆盖口径(本端点固定检索美国 USPTO 图形库) |
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);不代表数据新鲜度 |