GET已開放trademark-search

商標查詢

透過關鍵詞分頁查詢公開的商標名稱、註冊號、國際分類及狀態等登記資訊，適用於企業名稱核驗與初步檢索參考。

呼叫價格

10 匠幣/次

線上除錯

無需寫程式，瀏覽器中直接發起真實請求

接入文件

介面能力

本介面提供公開商標登記資訊的檢索服務。支援透過關鍵詞分頁查詢商標的詳細資訊，包括商標名稱、註冊號、國際分類（1-45類）、申請狀態（如註冊申請完成、實質審查等）以及申請人資訊。

請求與返回

請求引數：需傳入 keyword（查詢關鍵詞，如企業名稱或商標名稱）、pagenum（當前頁碼）、pagesize（每頁數量）以及 ismatch（匹配模式）。
返回結果：返回匹配的商標列表，包含總記錄數（total）以及具體的商標條目（名稱、註冊號、分類 ID、當前狀態等）。

使用場景

企業服務平臺：在公司註冊、品牌策劃等業務流程中，提供初步的商標名稱核驗工具。
智慧財產權管理：輔助企業或代理機構快速檢索特定關鍵詞的商標註冊情況，瞭解行業品牌佈局。
商業資訊查詢：整合到企業信用或商業資訊查詢平臺，豐富企業的無形資產展示維度。

使用說明與限制

免責宣告：本介面返回的商標結果僅供初步資訊查詢與參考，不構成任何商標註冊成功率的保證、近似判斷或法律結論。實際商標狀態與法律效力請以國家智慧財產權局商標局官方公告為準。
介面採用分頁機制，建議合理設定 pagesize（通常不超過 50）以保證響應速度。
關鍵詞檢索可能受限於公開資料的更新頻率，無法保證資料的絕對實時性，請在關鍵業務中結合官方渠道進行復核。

接入示例程式碼

提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。

請求示例

{
  "keyword": "华为",
  "pagenum": 1,
  "pagesize": 10,
  "ismatch": 0
}

響應示例

{
  "status": 0,
  "msg": "ok",
  "result": {
    "keyword": "华为",
    "pagenum": "1",
    "pagesize": "10",
    "total": "1",
    "list": [
      {
        "name": "示例商标",
        "regno": "1234****",
        "classid": "9",
        "status": "注册申请完成"
      }
    ]
  }
}

請求欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
keyword	string	华为
pagenum	number	1
pagesize	number	10
ismatch	number	0

響應欄位

以下欄位根據示例 JSON 自動提取，僅作接入參考。

欄位路徑	型別	示例值
status	number	0
msg	string	ok
result	object	{...}
result.keyword	string	华为
result.pagenum	string	1
result.pagesize	string	10
result.total	string	1
result.list	array

curl --request GET \ --url 'https://openapi.toolkk.com/v1/trademark-search' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "keyword": "华为",\n "pagenum": 1,\n "pagesize": 10,\n "ismatch": 0\n}'

import os import requests url = "https://openapi.toolkk.com/v1/trademark-search" payload = { "keyword": "华为", "pagenum": 1, "pagesize": 10, "ismatch": 0 } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.get(url, headers=headers, params=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/trademark-search" payload := []byte("{\n \"keyword\": \"华为\",\n \"pagenum\": 1,\n \"pagesize\": 10,\n \"ismatch\": 0\n}") req, err := http.NewRequest("GET", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"keyword\": \"华为\",\n \"pagenum\": 1,\n \"pagesize\": 10,\n \"ismatch\": 0\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/trademark-search")) .method("GET", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/trademark-search'; $payload = "{\n \"keyword\": \"华为\",\n \"pagenum\": 1,\n \"pagesize\": 10,\n \"ismatch\": 0\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;