この記事は、商標スクリーニングのリファレンスにあたる部分です。エンドポイント、パラメーター、フィールドを扱います。出品者が名称を確認するための手順は出品前の商標チェックにあります。
以下のすべてに一つの制約が当てはまります。API での検索はスクリーニングであり、使用可否の確認ではありません。 返すのはデータベースのレコードです。二つの商標が混同を生じるほど類似しているかは判断せず、弁理士や商標代理人の代わりにはなりません。
四つのエンドポイント
| エンドポイント | パス | 役割 |
|---|---|---|
| データの対応範囲 | /v1/global/brand/range | データで使われる官庁コードの一覧を返す |
| 商標検索 | /v1/global/brand/list | テキストでレコードを検索する。絞り込み可能 |
| 商標詳細 | /v1/global/brand/detail | id を指定して 1 件のレコードの全内容を返す |
| 商標統計 | /v1/global/brand/stats | 一致するレコードを官庁、ステータス、区分などで集計する |
成功した呼び出し 1 回につき課金単位を 1 つ消費します。
官庁コード
すべての問い合わせは office で範囲を指定します。コードの大半は 2 文字の国コードですが、国ではないものもいくつかあります。
| コード | 官庁 |
|---|---|
US、JP、GB、DE、CA、AU など | 各国の官庁 |
EM | 欧州連合 |
WO | WIPO が管理する国際登録 |
2026 年 10 月 12 日に対応範囲のエンドポイントを呼び出したところ、約 250 のコードが返りました。この一覧について知っておくべきことが二つあります。
- コードが一覧にあることは、データの完全性を意味しません。 そのコードが有効であることを示すだけで、その官庁のレコードがどれだけ新しく、どれだけそろっているかは示しません。頼る前に、すでに知っている商標でその官庁を試してください。
officeLabelは中国語で返ります。 自分のコードや画面ではofficeのコードを使ってください。
出品者にとって重要なのは、販売するマーケットプレイスの背後にある官庁です。ある名称が US では空いていて、EM ではすでに登録されていることがあります。
検索の絞り込み条件
必須のパラメーターは text だけです。それ以外はすべて結果を絞り込みます。
| パラメーター | 型 | 用途 |
|---|---|---|
text | String | 検索する語 |
office | Array | 一つ以上の官庁コード |
status | Array | レコードのステータス。Registered や Pending など |
niceClass | Array | 商品・役務の区分。数値で指定 |
applicant | Array | 出願人 |
brandName | Array | 完全一致の商標名 |
applicationYear、expiryYear | Array | 年。文字列で指定 |
order | Object | field と desc |
returnFields | String | 返すフィールド。カンマ区切り。レスポンスを小さくするために使う |
page、size | Integer | ページ送り |
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 件のレコードを返しました。
| 官庁別 | 件数 | ステータス別 | 件数 |
|---|---|---|---|
US | 2,063 | Ended | 1,419 |
EM | 391 | Registered | 897 |
JP | 225 | Pending | 227 |
Expired | 136 |
1 回の呼び出しから二つのことが読み取れます。
- レコードの半分以上はすでに効力がありません（
EndedまたはExpired）。単純な一致件数は障害を過大に見せます。 Registeredだけで絞ると、227 件の出願中のものが見えなくなります。 出願中のものは登録に至る可能性があるので、最初の確認では含めるべきです。
レコードを読む
| フィールド | 意味 |
|---|---|
id | レコードの識別子。詳細エンドポイントに brandId として渡す |
brandName | 商標の文字 |
applicant、applicantCountryCode | 出願人と、その所在国 |
applicationDate、applicationNumber | 出願日と出願番号 |
registrationNumber | 登録後に付く |
status、statusDate | 現在のステータスと、最後に変わった日 |
niceClass | 商標が対象とする区分 |
markFeature | 商標の種類。Combined は文字と図形の結合 |
office、designatedCountries | 官庁。国際登録の場合は指定国 |
詳細エンドポイントは、1 件のレコードについて、商品・役務の記載、手続きの履歴、存続期間の満了日を加えます。区分の番号は Amazon 出品者のための商標区分で説明しています。
この API が行わないこと
類似の判断はしません。 テキスト検索が見つけるのは一致する語です。商標は、つづりが同じでなくても、称呼、外観、観念で抵触することがあります。
区分の抵触は評価しません。 レコードがどの区分を対象としているかを報告します。自分の商品が抵触するかどうかは法律上の問題です。
官庁より遅れます。 公開とデータの登録には時間がかかるので、最近の出願はまだ現れないことがあります。
マーケットプレイスのブランド登録ではありません。 Amazon のブランド登録には独自の要件があります。
よくある質問
これは商標官庁の公式 API ですか。 いいえ。多数の官庁のレコードを一つのインターフェースで検索するものです。各官庁には独自の検索ツールもあり、その登録簿についてはそちらが正式な情報源です。
1 つの名称に何回の呼び出しが必要ですか。 内訳を見るための統計が 1 回、絞り込み条件の組み合わせごとに検索が 1 回、開くレコードごとに詳細が 1 回です。
複数の官庁を同時に検索できますか。
できます。office は配列です。
Amazon 関連の API の中で、どこに位置づけられますか。 Amazon API 一覧に挙げたエンドポイントの分類の一つで、商品、キーワード、市場と並びます。