快速开始

11 个法域、1,641 万条商标记录，一个 API Key 即可查询。 本页带你 5 分钟内完成注册、鉴权并拿到第一条真实检索结果。

1. 获取 API Key

在控制台注册（注册即自动创建组织），进入 API 密钥 页创建密钥。密钥只在创建时完整显示一次，请立即保存：

lgr_live_a1b2c3d4e5f6...

免费额度

Free 计划每月 1,000 点，无需绑卡。检索 10 点/页、详情 1 点/条、参考数据（/v1/offices 等）0 点。

2. 第一次检索

curl https://api.lagrange.so/v1/trademarks/search \
  -H "Authorization: Bearer $LGR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "CARA",
    "offices": ["TW", "EM", "WO"],
    "similarity": ["identical", "fuzzy"],
    "nice_classes": [9]
  }'

真实响应（字段结构与线上一致，此处只保留一条）：

{
  "total": 3,
  "results": [
    {
      "public_id": "TW-EE0233AE265A98F448F0",
      "mark_text": "CaraQ",
      "office": "TW",
      "reg_no": "02559720",
      "app_no": "115890016",
      "status": {
        "primary": "active",
        "stage": "registered",
        "challenges": []
      },
      "nice_classes": [9, 35, 38, 41, 42],
      "similarity": { "tier": "similar", "via": "fuzzy", "score": 0.87 },
      "owner_name": "卡拉科技有限公司",
      "office_url": "https://cloud.tipo.gov.tw/S282/S282WV1/..."
    }
  ],
  "page": { "size": 20, "number": 1 },
  "credits_charged": 10
}

几个值得注意的点：

• status.primary 只有 active / pending / dead 三个值，细分阶段在 status.stage。详见状态体系。
• similarity.tier + via 解释了"为什么这条算近似"：via: fuzzy 表示编辑距离命中，score 是归一化相似度。
• public_id 是稳定主键，可直接当 URL 路径用：GET /v1/trademarks/TW-EE0233AE265A98F448F0。

3. 取完整详情

检索接口只返回摘要。要拿商品服务、事件时间线、权利人链，取详情：

curl https://api.lagrange.so/v1/trademarks/TW-EE0233AE265A98F448F0 \
  -H "Authorization: Bearer $LGR_KEY"

事件时间线单独一个端点（可分页）：

curl "https://api.lagrange.so/v1/trademarks/TW-EE0233AE265A98F448F0/events?limit=50" \
  -H "Authorization: Bearer $LGR_KEY"

4. 下一步

• 鉴权与密钥：scope、过期时间与密钥轮换
• 数据模型：每条记录的字段语义与表关系
• 商标检索：全部过滤参数、相似度通道与翻页
• 数据覆盖：各局真实记录数与已知缺口

接口约定

• 布尔参数只接受 true / false，传 "1" 会返回 400
• 所有日期为 ISO 8601（2026-10-31），传时间戳会被拒绝
• 每个响应都带 credits_charged，失败请求不扣点
• offices 只接受覆盖矩阵内的代码；US / CA / CH 未接入，传了会返回 office_not_available