GETPublictrademark-search

Trademark Search

Paginated search for public trademark registration information including name, registration number, international class, and status via keywords, suitable for company name verification and preliminary search reference.

Usage Cost

10 coins/call

Try it online

Fire a real request right from your browser, no code required

Documentation

API Capabilities

This API provides retrieval services for public trademark registration information. It supports paginated keyword searches for detailed trademark information, including trademark name, registration number, international class (classes 1-45), application status (e.g., registration application completed, substantive examination, etc.), and applicant information.

Request and Response

Request Parameters: Requires keyword (search keyword, e.g., company name or trademark name), pagenum (current page number), pagesize (items per page), and ismatch (matching mode).
Response Result: Returns a list of matching trademarks, including the total number of records (total) and specific trademark entries (name, registration number, class ID, current status, etc.).

Use Cases

Enterprise Service Platforms: Provide preliminary trademark name verification tools in business processes such as company registration and brand planning.
Intellectual Property Management: Assist businesses or agencies in quickly searching for trademark registration status for specific keywords and understanding industry brand layouts.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

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

Response Example

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

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
keyword	string	华为
pagenum	number	1
pagesize	number	10
ismatch	number	0

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
status	number	0
msg	string	ok
result	object	{...}
result.keyword	string	华为
result.pagenum	string	1
result.pagesize	string	10
result.total	string	1

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;

Trademark Search

Try it online

Documentation

API Capabilities

Request and Response

Use Cases

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Usage Instructions and Limitations

Shell Example

Python Example

Go Example

Java Example

PHP Example