文本核名 · text-search
GET /v1/text-search
按商标名称检索注册库,容错召回同名/近似/义近,返回有效性、尼斯分类与相似度。
- 消耗:1 点
- 可用档位:免费版起
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
q | string | 是 | 候选商标名称/关键词 |
nice | string | 否 | 尼斯分类号(1–45),限定商品类目;留空=不限类 |
live | 0/1 | 否 | 仅返回有效在册(Live);默认包含全部 |
limit | int | 否 | 返回条数上限 |
country | string | 否 | 目标市场,默认 US;部分国家经伙伴数据源检索,按次加价 |
请求示例
- cURL
- Python
curl "https://radarsea.com/v1/v1/text-search?q=NIKE&nice=25&live=1&limit=20" \
-H "Authorization: Bearer one1_live_xxxxxxxx"
import requests
r = requests.get(
"https://radarsea.com/v1/v1/text-search",
params={"q": "NIKE", "nice": "25", "live": 1, "limit": 20},
headers={"Authorization": "Bearer one1_live_xxxxxxxx"},
)
print(r.json())
响应示例
{
"results": [
{ "serial": "78787878", "mark": "NIKE", "nice": "25",
"status": "Registered", "is_live": 1, "score": 0.98, "tro_hit": false }
],
"count": 1,
"data_as_of": "2026-07-14"
}
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
results[].serial | string | 商标序列号 |
results[].mark | string | 商标文本 |
results[].nice | string | 尼斯分类 |
results[].status | string | 法律状态 |
results[].is_live | 0/1 | 是否有效在册 |
results[].score | float | 相似度(0–1) |
results[].tro_hit | bool | 是否命中已知维权高危(仅布尔,不返回权利人名录) |
count | int | 结果条数 |
data_as_of | string | 数据批次日期 |
伙伴国
当 country 为经伙伴数据源检索的国家时,响应额外带 country 字段,且结果显式标注来源(不得当本地美国结果渲染)。