商标查询 API：局代码、筛选条件，以及一条记录怎么读

这篇是商标筛查的参考部分：接口、参数和字段。卖家查一个名字的分步流程，见上架前先查商标。

下面所有内容都受一条限制约束：API 查询是筛查，不是确权。 它返回的是数据库记录，不判断两个商标是否构成混淆性近似，也不能代替商标律师或代理人。

四个接口

每次成功调用消耗一个计费单位。

局代码

每次查询都由 office 限定范围。代码大多是两位国家代码，也有几个不是国家：

2026 年 10 月 12 日我们调用覆盖范围接口时，它返回了大约 250 个代码。关于这份列表要知道两点：

• 列出了某个代码，不代表数据完整。 它只说明这个代码有效，不说明该局的记录有多新、多全。在依赖某个局的数据之前，先用一个你已经了解的商标测一下。
• officeLabel 返回的是中文名称。 在你自己的代码和界面里请使用 office 代码。

对卖家来说，要紧的是你销售站点背后的那些局。一个名字可能在 US 没人用，在 EM 已经被注册。

查询的筛选条件

只有 text 是必填的，其余都用来收窄结果：

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", "EM"],
    "text": "AURORA",
    "status": ["Registered", "Pending"],
    "niceClass": [11],
    "page": 1,
    "size": 20
  }'

查询接口还接受以 imageBase64 传入的图片。写这篇文章时我们没有测试它，所以在依赖它之前，先用一个你了解的图形商标试一下。

为什么 status 不能只传一个值

先统计，再查询。统计接口能在你逐页翻看之前，显示记录是怎么分布的：

curl --request POST \
  --url https://ecommercedataapi.com/v1/global/brand/stats \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
    "office": ["US", "EM", "JP"],
    "text": "AURORA",
    "returnFields": "office,status,niceClass"
  }'

2026 年 10 月 12 日，这个请求返回了 2,679 条记录：

一次调用能读出两件事：

• 超过一半的记录已经失效（Ended 或 Expired）。直接看命中总数会高估障碍。
• 只筛 Registered 会漏掉 227 件在审申请。 在审申请可能变成注册商标，所以第一轮筛查应该把它包含进来。

读一条记录

详情接口为单条记录补充商品和服务描述、事件历史和到期日期。类别编号的含义见亚马逊卖家要了解的商标类别。

这个 API 不做的事

它不判断近似。 文字查询找到的是相同的词。商标可以在读音、外观或含义上冲突，而拼写并不相同。

它不评估类别冲突。 它报告一条记录覆盖哪些类别。你的商品是否冲突，是法律问题。

它落后于商标局。 公告和数据录入需要时间，所以最近提交的申请可能还查不到。

它不是电商平台的品牌备案。 亚马逊品牌备案有自己的要求。

常见问题

这是商标局的官方 API 吗？ 不是。它是通过一个接口查询多个局的记录。每个局也有自己的查询工具，那才是该局登记簿的权威来源。

查一个名字要调用几次？ 一次统计调用看分布，每组筛选条件一次查询，每打开一条记录一次详情调用。

能同时查多个局吗？ 可以。office 是数组。

它在亚马逊相关的 API 里处于什么位置？ 它是亚马逊 API 有哪些里列出的接口分组之一，和商品、关键词、市场并列。