全球商标库-详情
按知识产权机构和商标标识获取全球商标详情。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"office": "US",
"brandId": "US502022097612203"
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"id": "US502022097612203",
"applicant": [
"ANKER INC"
],
"applicantCountryCode": "US",
"applicants": [],
"applicationDate": "2022-09-29",
"applicationLanguageCode": "en",
"applicationNumber": "97612203",
"registrationNumber": "4590785",
"applicationRefNumber": [],
"brandName": [
"1ST AID"
],
"collection": "ustm",
"designatedCountries": [
"US"
],
"designation": [
"US"
],
"filingPlace": "Filing place example",
"kind": [
"Individual"
],
"logos": [
{
"logo": "Logo example",
"logoUrl": "Logo URL example"
}
],
"markFeature": "Combined",
"niceClass": [
5
],
"office": "US",
"status": "Pending",
"statusDate": "2023-05-02",
"type": "TRADEMARK",
"appeals": [
{
"date": "Date example",
"kind": "Kind example"
}
],
"correspondence": "Correspondence example",
"events": [
{
"date": "Date example",
"officeKind": "Office kind example",
"gbdKind": "Gbd kind example",
"doc": "Doc example",
"country": "Country example"
}
],
"expiryDate": "Expiry date example",
"extra": "Extra example",
"gbdStatus": "Gbd status example",
"goodsServicesClassification": {
"kind": "Kind example",
"version": "Version example",
"classification": {
"code": "Code example",
"terms": "Terms example"
}
},
"goodsServicesUnclassified": "Goods services unclassified example",
"markDescriptionDetails": [
{
"text": "ANKER INC",
"languageCode": "en"
}
],
"markDisclaimerDetails": [
{
"text": "ANKER INC",
"languageCode": "en"
}
],
"markImageDetails": [],
"nationalGoodsServicesClassification": {
"kind": "Kind example",
"version": "Version example",
"classification": {
"code": "Code example",
"terms": "Terms example"
}
},
"officeStatus": "Office status example",
"priorities": [
{
"severity": "Severity example",
"code": "Code example",
"field": "Field example",
"type": "Type example",
"message": "Message example"
}
],
"publicationDate": "Publication date example",
"publications": [
{
"date": "Date example",
"identifier": "Identifier example",
"section": "Section example"
}
],
"qc": [
{
"severity": "Severity example",
"code": "Code example",
"field": "Field example",
"type": "Type example",
"message": "Message example"
}
],
"reference": {
"office": "Office example",
"application": {
"date": "Date example",
"number": "Number example"
},
"registration": {
"date": "Date example",
"number": "Number example"
}
},
"refOffice": "Ref office example",
"registrationDate": "Registration date example",
"registrationOfficeCode": "Registration office code example",
"registrationRefNumber": [],
"representatives": [],
"secondLanguageCode": "Second language code example",
"st13": "St13 example",
"terminationDate": "Termination date example",
"wordMarkSpecification": {
"markTransliteration": "Mark transliteration example",
"markTranslation": {
"text": "Text example",
"languageCode": "Language code example"
},
"markVerbalElement": {
"text": "Text example",
"languageCode": "Language code example"
},
"markSignificantVerbalElement": {
"text": "SONICARE",
"languageCode": "en"
}
}
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/global/brand/detail
下方请求和响应字段已与当前公开契约核对。
接口对应关系
| 项目 | 内容 |
|---|---|
| MCP Code | trademark_detail |
| 原始 REST 方法 | GET |
| 原始 REST 路径 | /v1/global/brand/detail |
| 原始 API 文档 | 打开官方 API 文档 |
历史路径仍可调用,但已弃用:
/v1/global/trademarks/details。兼容请求会返回Deprecation: true和指向规范路径的Link响应头。
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/global/brand/detail \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"office": "US",
"brandId": "US502022097612203"
}'使用 AI CLI 接入
复制给 AI CLI
粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。
请直接在当前代码库中接入 Ecommerce Data API 的「全球商标库-详情」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/global/brand/detail
请求接口:POST https://ecommercedataapi.com/v1/global/brand/detail
API 密钥环境变量:ECOMMERCE_DATA_API_KEY
请求示例:
{
"office": "US",
"brandId": "US502022097612203"
}
请按以下要求执行:
1. 先阅读接口文档,并检查当前项目使用的语言、框架、HTTP 客户端、目录结构和环境变量约定。
2. 优先复用项目现有的 API 客户端和错误处理方式;如果没有,再创建最小可复用的 Ecommerce Data API 客户端与该接口调用封装。
3. 从服务端环境变量 ECOMMERCE_DATA_API_KEY 读取密钥,发送 Content-Type: application/json 和 X-API-Key 请求头。绝不能把真实密钥写入源码、前端代码、日志、测试快照或 Git。
4. 如果环境变量不存在,提示我自行设置 ECOMMERCE_DATA_API_KEY;不要索取、输出或猜测真实密钥,并继续完成不依赖真实请求的代码与测试。
5. 根据接口文档实现请求与响应类型,处理非 2xx 响应、request_id、error.code、error.message 和 429 限流。
6. 添加一个符合当前项目习惯的最小调用示例或测试。如果密钥已配置且当前环境允许外部请求,再执行一次最小真实调用;否则使用 mock 或静态验证。
7. 运行相关格式化、类型检查和测试,最后汇报修改文件、调用方法、验证结果以及仍需我配置的环境变量。还没有 API 密钥?创建 API 密钥
在 Postman 中打开当前请求
下载当前接口的预配置 Collection,再通过 Postman Import 导入。
导入后在 Collection Variables 中填写 apiKey。创建 API 密钥
Node.js 示例
const response = await fetch(
'https://ecommercedataapi.com/v1/global/brand/detail',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
office: 'US',
brandId: 'US502022097612203',
}),
}
);
const result = await response.json();
if (!response.ok) {
throw new Error(`${result.error?.code}: ${result.error?.message}`);
}
console.log(result.data);Python 示例
import os
import requests
response = requests.post(
"https://ecommercedataapi.com/v1/global/brand/detail",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"office": "US",
"brandId": "US502022097612203",
},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])请求参数
请求体直接发送下表字段,不要再包裹额外对象;未定义字段会被拒绝。
| 字段 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
office | 字符串 | 是 | 数据范围,可通过数据范围接口查询 | US |
brandId | 字符串 | 是 | id,见列表接口 | US502022097612203 |
returnFields | 字符串 | 否 | 可选的返回字段选择字符串;不传时返回标准字段。 | id,applicant,applicantCountryCode |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
id | 字符串 | id | US502022097612203 |
applicant | 数组 | 申请人 | ANKER INC |
applicantCountryCode | 字符串 | 申请人国家 | US |
applicants | 数组 | 申请人详情 | 格式同office,结构见下表 |
applicationDate | 字符串 | 申请日期 | 2022-09-29 |
applicationLanguageCode | 字符串 | 申请语言 | en |
applicationNumber | 字符串 | 申请编号 | 97612203 |
registrationNumber | 字符串 | 注册号 | 4590785 |
applicationRefNumber | 数组 | 申请参考号 | - |
brandName | 数组 | 品牌名 | [ "1ST AID"] |
collection | 字符串 | 数据集 | ustm |
designatedCountries | 数组 | 指定国家 | ["US"] |
designation | 数组 | 指定国家 | ["US"] |
filingPlace | 字符串 | 申请地点 | - |
kind | 数组 | 商标类别 | ["Individual"] |
logos | 数组 | logo | - |
logos.logo | 字符串 | logo | - |
logos.logoUrl | 字符串 | logo url | - |
markFeature | 字符串 | 商标种类 | Combined |
niceClass | 数组 | 尼斯分类 | [5] |
office | 字符串 | 知识产权局 | US |
status | 字符串 | 状态 | Pending |
statusDate | 字符串 | 状态更新日期 | 2023-05-02 |
type | 字符串 | 类型 | TRADEMARK |
appeals | 数组 | 上诉信息 | - |
appeals.date | 字符串 | 日期 | - |
appeals.kind | 字符串 | 分类 | - |
correspondence | 字符串 | 通信地址 | - |
events | 数组 | 事件 | - |
events.date | 字符串 | 日期 | - |
events.officeKind | 字符串 | 产权局分类 | - |
events.gbdKind | 字符串 | 品牌分析 | - |
events.doc | 字符串 | 文档 | - |
events.country | 字符串 | 国家 | - |
expiryDate | 字符串 | 过期时间 | - |
extra | 字符串 | 扩展信息 | - |
gbdStatus | 字符串 | 品牌状态 | - |
goodsServicesClassification | 对象 | 商品分类信息 | - |
goodsServicesClassification.kind | 字符串 | 类型 | - |
goodsServicesClassification.version | 字符串 | 版本 | - |
goodsServicesClassification.classification | 字符串 | 详情 | - |
goodsServicesClassification.classification.code | 字符串 | code码 | - |
goodsServicesClassification.classification.terms | 字符串 | 说明 | - |
goodsServicesUnclassified | 字符串 | 商品未分类信息 | - |
markDescriptionDetails | 数组 | 商标描述细节 | - |
markDescriptionDetails.text | 字符串 | 描述 | ANKER INC |
markDescriptionDetails.languageCode | 字符串 | 语言 | en |
markDisclaimerDetails | 数组 | 商标免责声明 | - |
markDisclaimerDetails.text | 字符串 | 描述 | ANKER INC |
markDisclaimerDetails.languageCode | 字符串 | 语言 | en |
markImageDetails | 数组 | 商标图形分类 | - |
nationalGoodsServicesClassification | 对象 | 国际商品分类信息 | - |
nationalGoodsServicesClassification.kind | 字符串 | 类型 | - |
nationalGoodsServicesClassification.version | 字符串 | 版本 | - |
nationalGoodsServicesClassification.classification | 字符串 | 详情 | - |
nationalGoodsServicesClassification.classification.code | 字符串 | code码 | - |
nationalGoodsServicesClassification.classification.terms | 字符串 | 说明 | - |
officeStatus | 字符串 | 办公状态 | - |
priorities | 数组 | 优先事项 | - |
priorities.severity | 字符串 | 级别 | - |
priorities.code | 字符串 | code码 | - |
priorities.field | 字符串 | 字段 | - |
priorities.type | 字符串 | 类型 | - |
priorities.message | 字符串 | 说明 | - |
publicationDate | 字符串 | 发表日期 | - |
publications | 数组 | 发表详情 | - |
publications.date | 字符串 | 日期 | - |
publications.identifier | 字符串 | 标志 | - |
publications.section | 字符串 | 内容 | - |
qc | 数组 | 审核意见 | - |
qc.severity | 字符串 | 级别 | - |
qc.code | 字符串 | code码 | - |
qc.field | 字符串 | 字段 | - |
qc.type | 字符串 | 类型 | - |
qc.message | 字符串 | 说明 | - |
reference | 对象 | 参考信息 | - |
reference.office | 字符串 | 机构code | - |
reference.application | 对象 | 申请信息 | - |
reference.application.date | 字符串 | 日期 | - |
reference.application.number | 字符串 | 编号 | - |
reference.registration | 对象 | 注册信息 | - |
reference.registration.date | 字符串 | 日期 | - |
reference.registration.number | 字符串 | 编号 | - |
refOffice | 字符串 | 参考办公室 | - |
registrationDate | 字符串 | 注册日期 | - |
registrationOfficeCode | 字符串 | 注册国家 | - |
registrationRefNumber | 数组 | 注册参考号 | - |
representatives | 数组 | 代表信息 | - |
secondLanguageCode | 字符串 | 第二语言 | - |
st13 | 字符串 | id | - |
terminationDate | 字符串 | 终止日期 | - |
wordMarkSpecification | 对象 | 文字商标说明 | - |
wordMarkSpecification.markTransliteration | 字符串 | markTransliteration | - |
wordMarkSpecification.markTranslation | 对象 | 商标翻译 | - |
wordMarkSpecification.markTranslation.text | 字符串 | 内容 | - |
wordMarkSpecification.markTranslation.languageCode | 字符串 | 语言类型 | - |
wordMarkSpecification.markVerbalElement | 对象 | markVerbalElement | - |
wordMarkSpecification.markVerbalElement.text | 字符串 | 内容 | - |
wordMarkSpecification.markVerbalElement.languageCode | 字符串 | 语言类型 | - |
wordMarkSpecification.markSignificantVerbalElement | 对象 | markSignificantVerbalElement | - |
wordMarkSpecification.markSignificantVerbalElement.text | 字符串 | 内容 | SONICARE |
wordMarkSpecification.markSignificantVerbalElement.languageCode | 字符串 | 语言类型 | en |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"id": "US502022097612203",
"applicant": ["ANKER INC"],
"applicantCountryCode": "US",
"applicants": [],
"applicationDate": "2022-09-29",
"applicationLanguageCode": "en",
"applicationNumber": "97612203",
"registrationNumber": "4590785",
"applicationRefNumber": [],
"brandName": ["1ST AID"],
"collection": "ustm",
"designatedCountries": ["US"],
"designation": ["US"],
"filingPlace": "Filing place example",
"kind": ["Individual"],
"logos": [
{
"logo": "Logo example",
"logoUrl": "Logo URL example"
}
],
"markFeature": "Combined",
"niceClass": [5],
"office": "US",
"status": "Pending",
"statusDate": "2023-05-02",
"type": "TRADEMARK",
"appeals": [
{
"date": "Date example",
"kind": "Kind example"
}
],
"correspondence": "Correspondence example",
"events": [
{
"date": "Date example",
"officeKind": "Office kind example",
"gbdKind": "Gbd kind example",
"doc": "Doc example",
"country": "Country example"
}
],
"expiryDate": "Expiry date example",
"extra": "Extra example",
"gbdStatus": "Gbd status example",
"goodsServicesClassification": {
"kind": "Kind example",
"version": "Version example",
"classification": {
"code": "Code example",
"terms": "Terms example"
}
},
"goodsServicesUnclassified": "Goods services unclassified example",
"markDescriptionDetails": [
{
"text": "ANKER INC",
"languageCode": "en"
}
],
"markDisclaimerDetails": [
{
"text": "ANKER INC",
"languageCode": "en"
}
],
"markImageDetails": [],
"nationalGoodsServicesClassification": {
"kind": "Kind example",
"version": "Version example",
"classification": {
"code": "Code example",
"terms": "Terms example"
}
},
"officeStatus": "Office status example",
"priorities": [
{
"severity": "Severity example",
"code": "Code example",
"field": "Field example",
"type": "Type example",
"message": "Message example"
}
],
"publicationDate": "Publication date example",
"publications": [
{
"date": "Date example",
"identifier": "Identifier example",
"section": "Section example"
}
],
"qc": [
{
"severity": "Severity example",
"code": "Code example",
"field": "Field example",
"type": "Type example",
"message": "Message example"
}
],
"reference": {
"office": "Office example",
"application": {
"date": "Date example",
"number": "Number example"
},
"registration": {
"date": "Date example",
"number": "Number example"
}
},
"refOffice": "Ref office example",
"registrationDate": "Registration date example",
"registrationOfficeCode": "Registration office code example",
"registrationRefNumber": [],
"representatives": [],
"secondLanguageCode": "Second language code example",
"st13": "St13 example",
"terminationDate": "Termination date example",
"wordMarkSpecification": {
"markTransliteration": "Mark transliteration example",
"markTranslation": {
"text": "Text example",
"languageCode": "Language code example"
},
"markVerbalElement": {
"text": "Text example",
"languageCode": "Language code example"
},
"markSignificantVerbalElement": {
"text": "SONICARE",
"languageCode": "en"
}
}
}
}错误响应、请求追踪和限流头说明见错误与限流。