全球商标库-列表
查询受支持知识产权机构中的全球商标列表。
API 数据样例
直接查看该接口实际使用的请求体和完整响应结构。
{
"office": [
"US"
],
"text": "ANKER",
"status": [
"Registered"
],
"order": {
"field": "applicationDate",
"desc": true
},
"page": 1,
"size": 20
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"pages": 1,
"page": 1,
"size": 20,
"total": 1,
"items": [
{
"id": "US502022097612203",
"applicant": [
"ANKER INC"
],
"applicantCountryCode": "US",
"applicants": [
{
"kind": "Legal Entity",
"identifier": "33744042",
"countryCode": "US",
"contact": {},
"fullAddress": [
{
"text": "Text example",
"languageCode": "en",
"imageUrl": "Image URL example"
}
],
"fullName": [
{
"text": "ANKER INC",
"languageCode": "en"
}
]
}
],
"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"
}
]
}
}可用状态:已开放
该接口已进入 v1 网关、OpenAPI 和订阅权限目录,成功调用一次消耗 1 个计费单位。
POST /v1/global/brand/list
下方请求和响应字段已与当前公开契约核对。
接口对应关系
| 项目 | 内容 |
|---|---|
| MCP Code | trademark_list |
| 原始 REST 方法 | POST |
| 原始 REST 路径 | /v1/global/brand/list |
| 原始 API 文档 | 打开官方 API 文档 |
历史路径仍可调用,但已弃用:
/v1/global/trademarks/search。兼容请求会返回Deprecation: true和指向规范路径的Link响应头。
快速调用
先创建 API 密钥,再将密钥写入服务端环境变量:
export ECOMMERCE_DATA_API_KEY="your_api_key"curl --request POST \
--url https://ecommercedataapi.com/v1/global/brand/list \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"office": [
"US"
],
"text": "ANKER",
"status": [
"Registered"
],
"order": {
"field": "applicationDate",
"desc": true
},
"page": 1,
"size": 20
}'使用 AI CLI 接入
复制给 AI CLI
粘贴到 Codex、Claude Code、Gemini CLI 或其他编程智能体中直接完成接入。
请直接在当前代码库中接入 Ecommerce Data API 的「全球商标库-列表」接口,不要只给示例代码。
接口文档:https://ecommercedataapi.com/zh/docs/global/brand/list
请求接口:POST https://ecommercedataapi.com/v1/global/brand/list
API 密钥环境变量:ECOMMERCE_DATA_API_KEY
请求示例:
{
"office": [
"US"
],
"text": "ANKER",
"status": [
"Registered"
],
"order": {
"field": "applicationDate",
"desc": true
},
"page": 1,
"size": 20
}
请按以下要求执行:
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/list',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
office: ['US'],
text: 'ANKER',
status: ['Registered'],
order: {
field: 'applicationDate',
desc: true,
},
page: 1,
size: 20,
}),
}
);
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/list",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"office": [
"US",
],
"text": "ANKER",
"status": [
"Registered",
],
"order": {
"field": "applicationDate",
"desc": True,
},
"page": 1,
"size": 20,
},
timeout=30,
)
response.raise_for_status()
print(response.json()["data"])请求参数
请求体直接发送下表字段,不要再包裹额外对象;未定义字段会被拒绝。
| 字段 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
applicant | 数组 | 否 | 申请人,字段参数见统计接口 | ["ANKER INC"] |
applicationYear | 数组 | 否 | 申请年份,字段参数见统计接口 | ["1985"] |
brandName | 数组 | 否 | 品牌名,字段参数见统计接口 | ["ADVENTURE CLUB"] |
expiryYear | 数组 | 否 | 过期年份,字段参数见统计接口 | ["2026"] |
imageBase64 | 字符串 | 否 | base64字符串 | Image base64 |
niceClass | 数组 | 否 | 尼斯分类,字段参数见统计接口 | [5] |
office | 数组 | 否 | 数据范围,可通过数据范围接口查询 | ["US"] |
order | 对象 | 否 | 排序配置对象。 | {} |
order.desc | 布尔值 | 否 | true降序,false升序,默认true | true |
order.field | 字符串 | 否 | 排序字段,默认相关度,applicationDate申请日期 | searches |
page | 整数 | 否 | 页码 最小值:1。 | 1 |
returnFields | 字符串 | 否 | 可选的返回字段选择字符串;不传时返回标准字段。 | id,applicant,applicantCountryCode |
size | 整数 | 否 | 每页条数,最大100 最小值:1。 | 20 |
status | 数组 | 否 | 状态,字段参数见统计接口 | ["Registered"] |
text | 字符串 | 是 | 查询文本 | CHINESE |
返回结构
| 字段 | 类型 | 说明 |
|---|---|---|
request_id | 字符串 | 本次请求的唯一标识。 |
data | 对象 | 接口业务数据。 |
下表字段位于 data 内。数组接口描述的是单个数组元素,分页接口描述的是 items[] 中的单条记录。
返回字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
id | 字符串 | id | US502022097612203 |
applicant | 数组 | 申请人 | ANKER INC |
applicantCountryCode | 字符串 | 申请人国家 | US |
applicants | 数组 | 申请人详情 | 格式同office |
applicants.kind | 字符串 | 类型 | Legal Entity |
applicants.identifier | 字符串 | 标识 | 33744042 |
applicants.countryCode | 字符串 | 国家编码 | US |
applicants.contact | 对象 | 联系方式 | - |
applicants.fullAddress | 数组 | 完整地址 | - |
applicants.fullAddress.text | 字符串 | 描述 | - |
applicants.fullAddress.languageCode | 字符串 | 语言 | en |
applicants.fullAddress.imageUrl | 字符串 | 图片URL | - |
applicants.fullName | 数组 | 完整名称 | - |
applicants.fullName.text | 字符串 | 描述 | ANKER INC |
applicants.fullName.languageCode | 字符串 | 语言 | en |
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 |
返回示例
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"pages": 1,
"page": 1,
"size": 20,
"total": 1,
"items": [
{
"id": "US502022097612203",
"applicant": ["ANKER INC"],
"applicantCountryCode": "US",
"applicants": [
{
"kind": "Legal Entity",
"identifier": "33744042",
"countryCode": "US",
"contact": {},
"fullAddress": [
{
"text": "Text example",
"languageCode": "en",
"imageUrl": "Image URL example"
}
],
"fullName": [
{
"text": "ANKER INC",
"languageCode": "en"
}
]
}
],
"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"
}
]
}
}错误响应、请求追踪和限流头说明见错误与限流。
可组合使用的 AI Skills 与 Agents
从业务任务出发,查看这些能力如何使用当前 API,并在安装前审阅来源与权限。
Ecommerce Data API Agent Skill
在支持的 AI 编程 Agent 中发现、检查并调用实时 Amazon 商品、关键词、市场、流量、评论和商标 API。
跨境电商市场扩张 Skill
比较目标市场、履约模式、税务、支付偏好、本地化要求和分阶段国际扩张方案。
Amazon 全球开店规划 Skill
从需求、经济模型、税务、合规、物流、本地化、账号和发布门禁评估 Amazon 全球扩张。
TikTok Shop 跨境扩张 Skill
规划 TikTok Shop 市场进入、物流、本地化、达人运营、税务、合规和国际上线。