trademark_api

# USPTO 商标 API 参考 ## 概述 USPTO 为商标数据提供了两个主要 API： 1. **商标状态与文档检索 (TSDR)** - 检索商标案件状态和文档 2. **商标转让搜索 (Trademark Assignment Search)** - 搜索商标转让记录 ## 1. 商标状态与文档检索 (TSDR) API ### 概述 TSDR 支持以编程方式检索商标案件状态文档和信息。 **API 版本:** v1.0 **基础 URL:** `https://tsdrapi.uspto.gov/ts/cd/` ### 身份验证 需要在以下地址注册 API 密钥：https://account.uspto.gov/api-manager/ 在请求头中包含 API 密钥： X-Api-Key: YOUR_API_KEY ### 端点 #### 按序列号获取商标状态 GET /ts/cd/casedocs/sn{serial_number}/info.json **示例:** bash curl -H "X-Api-Key: YOUR_KEY" "https://tsdrapi.uspto.gov/ts/cd/casedocs/sn87654321/info.json" #### 按注册号获取商标状态 GET /ts/cd/casedocs/rn{registration_number}/info.json ### 响应格式 返回包含全面商标信息的 JSON： { "TradeMarkAppln": { "ApplicationNumber": "87654321", "ApplicationDate": "2017-10-15", "RegistrationNumber": "5678901", "RegistrationDate": "2019-03-12", "MarkVerbalElementText": "EXAMPLE MARK", "MarkCurrentStatusExternalDescriptionText": "REGISTERED", "MarkCurrentStatusDate": "2019-03-12", "GoodsAndServices": [...], "Owners": [...], "Correspondents": [...] } } ### 关键数据字段 - **申请信息:** - `ApplicationNumber` - 序列号 - `ApplicationDate` - 申请日期 - `ApplicationType` - 类型 (TEAS Plus, TEAS Standard 等) - **注册信息:** - `RegistrationNumber` - 注册号 (如果已注册) - `RegistrationDate` - 注册日期 - **商标信息:** - `MarkVerbalElementText` - 商标文字内容 - `MarkCurrentStatusExternalDescriptionText` - 当前状态 - `MarkCurrentStatusDate` - 状态日期 - `MarkDrawingCode` - 商标类型 (文字、设计等) - **分类:** - `GoodsAndServices` - 包含类别的商品/服务数组 - **所有者信息:** - `Owners` - 商标所有者/申请人数组 - **审查历史:** - `ProsecutionHistoryEntry` - 审查过程中的事件数组 ### 常见状态值 - **REGISTERED** - 商标已注册且有效 - **PENDING** - 申请正在审查中 - **ABANDONED** - 申请/注册已放弃