商标情报，直接嵌入你的技术栈。
通过简单的 REST API,检索美国等 30+ 国/地区商标注册库、运行 Logo 图像相似度比对、批量筛查产品 Listing 的撞标风险。免费开始,无需信用卡。
# 检索商标注册库(country 可选 30+ 法域,默认美国)
curl "https://one1.cn/v1/text-search?q=NIKE&nice=25" \
-H "Authorization: Bearer one1_live_••••••••"
# → { "results": [ … ], "count": 128, "coverage": { "scope": "full", … }, "request_id": "…", "timestamp": "…" }五大能力，一把 API 密钥。
每个接口都返回干净的 JSON,并附带辖区覆盖度(coverage)与请求追踪 ID(request_id)。使用 Bearer 密钥鉴权,按点数计量(各接口点价见下方速查表)。
文字检测
按商标名称检索 30+ 国 / 地区官方注册库(country 参数直通,美国库最快)—— 容错召回,涵盖有效 / 失效状态、申请人及尼斯分类。
图形代码检索
按 USPTO 图形检索代码和尼斯分类查找图形商标 —— 附带持有人与有效状态。
Logo 图像检索
上传 Logo,通过 CLIP 向量检索美国及中国近似图形商标;中国当前为仅在效、持续补全中的增量 Beta。
Listing 筛查
批量筛查产品标题中夹带的商标 —— 品牌词提取叠加通用词过滤,逐条给出风险。
风险结论
结构化的 避让 / 谨慎 / 通行 结论,并附上判定理由 —— 与 One1 应用同一套规则层。
三步即可上线。
创建密钥
登录后,在开发者控制台生成密钥。明文密钥只显示一次 —— 请妥善保存。
鉴权
以 Bearer Token 方式传入密钥:Authorization: Bearer one1_live_…
读取响应
每次调用都返回 JSON,顶层自带 request_id(= 响应头 X-Request-Id)与 timestamp;计费接口响应头附带 X-Charged / X-Quota-Remaining,方便你追踪用量。错误统一返回 {"error":{"code","message","retryable"}},状态码为 400 / 401 / 402 / 403 / 429 / 503,429 / 503 带 Retry-After,详见下方错误码表。
| 方法 | 接口 | 说明 | 消耗(点) |
|---|---|---|---|
| 全部套餐可用含免费版 | |||
| GET | /v1/text-search | 按名称检索 30+ 国 / 地区注册库伙伴国辖区(经合作方提供)需付费套餐 | 20 |
| GET | /v1/graphic | 按 USPTO 图形代码检索 | 30 |
| POST | /v1/image-search | 按 Logo 检索 US / CN 图形商标 | 30 |
| POST | /v1/batch-screen | 筛查 Listing 撞标 | 20 / 条 |
| POST | /v1/advice | 结构化风险结论 | 20 |
| GET | /v1/customs/risk | 海关备案查扣风险 | 2 |
| GET | /v1/policy/query | Amazon + TikTok 平台政策查询 | 3 |
| GET | /v1/epo-search | 欧洲专利文献检索(Beta) | 2 |
| POST | /v1/policy/feature/* | 政策合规 · 风险特征词管理(联想 / 保存 / 删除 / 列表) | 0 |
| GET | /v1/account/credits | 查询账户 API 点余额 | 0 |
| 需付费套餐(入门版起)第三方数据源 / 大模型接口,有真实成本;只从套餐月度点扣除,赠送点不可用 | |||
| POST | /v1/listing/fix | Listing 合规改写(第三方大模型) | 5 |
| POST | /v1/patent/design | 外观专利检测 | 50 / 深度 75 |
| POST | /v1/patent/invention | 发明专利检测 | 50 |
| POST | /v1/trademark/safe-words | 文本商标安全词 | 5 |
| POST | /v1/copyright/detect | 版权检测 | 5 / 深度 10 |
| POST | /v1/policy/image | 政策合规(图片) | 5 |
| POST | /v1/policy/text | 政策合规(文本) | 25 + 10 / 特征词 |
错误码
错误体统一为 {"error":{"code","message","retryable"}},先按 HTTP 状态码分支,再用 code 细分;retryable 为 true 时可按 Retry-After 退避后重试。
| HTTP | code | 含义 |
|---|---|---|
| 400 | bad_request | 参数缺失或不合法 |
| 401 | invalid_key | 缺少或无效的 API Key |
| 402 | quota_exceededinsufficient_creditscash_quota_exhausted | API 点不足,本次未扣点。quota_exceeded(常规接口)与 insufficient_credits(第三方合规接口):点数余额不足,请续费或升级套餐;cash_quota_exhausted:第三方数据源接口只从套餐月度点扣除,本月套餐点已用完(赠送点不可用) |
| 403 | paid_plan_required | 免费版调用第三方数据源接口(未扣点),购买任一 API 套餐即可使用 |
| 403 | key_owner_missing | Key 有效,但绑定邮箱尚未开通 One1 账号,无法计费 |
| 429 | rate_limited | 超出本档每账户限速,响应带 Retry-After: 1,请按其秒数退避后重试或升级套餐 |
| 503 | busycountry_unavailableupstream_errordata_unavailableepo_unavailable | 均为 retryable:true。busy:Listing 改写繁忙,响应带 Retry-After: 5;country_unavailable / upstream_error / data_unavailable:该辖区、第三方数据源或服务暂不可用,响应带 Retry-After: 2;epo_unavailable:EPO 检索暂不可用;请按秒数退避后重试 |
免费开始，按需扩容。
每个账户可免费创建密钥(每月 1,000 API 点)。自有接口全档可用;更高额度、第三方合规接口与更高限速在付费档。API 点与应用积分相互独立。
免费版
每月 1,000 点(≈50 次文本检索)· 免费评估
- 全部自有接口:文本(本地辖区)、图形、以图搜图、批量、结论、海关、政策、EPO、MCP(仅本地辖区)
- 第三方合规(专利/版权/安全词/政策图文)、伙伴国辖区、Listing 改写需付费套餐
- 每账户 1 次/秒 · 突发 10
- 最多 3 把 API Key
- 邮件支持
入门版
每月 20,000 点(≈1,000 次文本检索)
- 全部接口:含第三方合规(专利/版权/安全词/政策图文)、伙伴国辖区、Listing 改写
- 每账户 2 次/秒 · 突发 30
- 最多 5 把 API Key
- 邮件支持
- · 限速按账户计:登录态与该账户下所有 Key 共用同一额度;另外,同一出口 IP 的全部请求合计不超过 20 次/秒。
- · 第三方数据源接口 —— 第三方合规(专利/版权/安全词/政策图文)、伙伴国辖区检索、Listing 改写 —— 只从套餐月度点扣除,赠送点不可用于这些接口。
- · MCP 仅覆盖本地辖区:伙伴国辖区任何档位都不可用(请改用 REST /v1/text-search),且不含第三方合规检测与 Listing 改写。
- · 更大用量或定制需求,请邮件联系 radarone1@163.com。
文本检索 30+ 国 / 地区(部分辖区经合作方提供),以图搜图 US / CN;实时覆盖以 coverage 接口(GET /api/coverage?country=XX)为准。每个响应自带 request_id 与 timestamp,检索类接口另带 coverage(scope / warning / clearance_ok)标注辖区覆盖度,伙伴国辖区结果显式标注 source=partner:ruiguan;本 API 返回的是注册库事实与基于规则的风险视图 —— 不构成法律意见。