Trademark Search API Documentation

Use the Trademark Search API for ecommerce brand and trademark research. Review request parameters, response fields, and runnable examples.

Availability: Available

This endpoint is active in the v1 gateway, OpenAPI, and subscription catalog. A successful call consumes 1 billing unit.

POST /v1/global/trademarks/search

The request and response fields below match the current public contract.

Quick call

First create an API key, then store it in a server-side environment variable:

export ECOMMERCE_DATA_API_KEY="your_api_key"

curl --request POST \
  --url https://ecommercedataapi.com/v1/global/trademarks/search \
  --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
}'

Integrate with an AI CLI

Copy for your AI CLI

Paste this task into Codex, Claude Code, Gemini CLI, or another coding agent.

Integrate the "Trademark Search" endpoint from Ecommerce Data API into the current repository. Make the changes directly instead of only returning sample code.

API documentation: https://ecommercedataapi.com/en/docs/global/trademarks/search
Endpoint: POST https://ecommercedataapi.com/v1/global/trademarks/search
API key environment variable: ECOMMERCE_DATA_API_KEY

Example request:
{
"office": [
"US"
],
"text": "ANKER",
"status": [
"Registered"
],
"order": {
"field": "applicationDate",
"desc": true
},
"page": 1,
"size": 20
}

Requirements:
1. Read the API documentation first, then inspect the repository's language, framework, HTTP client, directory structure, and environment-variable conventions.
2. Reuse the existing API client and error-handling patterns. If none exist, add the smallest reusable Ecommerce Data API client and an endpoint-specific wrapper.
3. Read the key from the server-side ECOMMERCE_DATA_API_KEY environment variable and send Content-Type: application/json plus the X-API-Key header. Never write a real key into source code, browser code, logs, test snapshots, or Git.
4. If the environment variable is missing, tell me to configure ECOMMERCE_DATA_API_KEY myself. Do not request, print, or invent the real key, and continue implementing code and tests that do not require a live request.
5. Implement request and response types from the documentation. Handle non-2xx responses, request_id, error.code, error.message, and 429 rate limits.
6. Add a minimal usage example or test that follows the repository's conventions. Run one minimal live request only when the key is already configured and external requests are allowed; otherwise use mocks or static validation.
7. Run the relevant formatter, type checker, and tests. Report changed files, usage, verification results, and any environment variable I still need to configure.

Need an API key?Create API key

Open this request in Postman

Download the preconfigured collection for this endpoint, then import it into Postman.

Download Postman config

Set the apiKey collection variable after import.Create API key

Node.js example

const response = await fetch(
  'https://ecommercedataapi.com/v1/global/trademarks/search',
  {
    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 example

import os
import requests

response = requests.post(
    "https://ecommercedataapi.com/v1/global/trademarks/search",
    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"])

Request body

Send the fields below directly in the JSON body without an extra wrapper. Undefined fields are rejected.

Field	Type	Required	Description	Example
`applicant`	Array	No	Applicant.	["ANKER INC"]
`applicationYear`	Array	No	Application year.	["1985"]
`brandName`	Array	No	Brand name.	["ADVENTURE CLUB"]
`expiryYear`	Array	No	Expiry year.	["2026"]
`imageBase64`	String	No	Image base64.	Image base64
`niceClass`	Array	No	Nice class.	[5]
`office`	Array	No	Trademark office or list of trademark offices.	["US"]
`order`	Object	No	Sort definition.	{}
`order.desc`	Boolean	No	Use true for descending order or false for ascending order.	true
`order.field`	String	No	Field used to sort the results.	searches
`page`	Integer	No	Page number starting at 1.	1
`returnFields`	String	No	Optional comma-separated response fields. Omit it to receive the standard payload.	id,applicant,applicantCountryCode
`size`	Integer	No	Number of results per page.	20
`status`	Array	No	Status.	["Registered"]
`text`	String	Yes	Text used by the query.	CHINESE

Response structure

Field	Type	Description
`request_id`	String	Unique identifier for this request.
`data`	Object	Endpoint business data.

The fields below are inside data. For array endpoints they describe one array item; for paginated endpoints they describe one record in items[].

Response fields

Field	Type	Description	Example
`id`	String	ID.	US502022097612203
`applicant`	Array	Applicant.	ANKER INC
`applicantCountryCode`	String	Applicant country code.	US
`applicants`	Array	Applicants.	格式同office
`applicants.kind`	String	Kind.	Legal Entity
`applicants.identifier`	String	Identifier.	33744042
`applicants.countryCode`	String	Country code.	US
`applicants.contact`	Object	Contact.	-
`applicants.fullAddress`	Array	Full address.	-
`applicants.fullAddress.text`	String	Text.	-
`applicants.fullAddress.languageCode`	String	Language code.	en
`applicants.fullAddress.imageUrl`	String	Image URL.	-
`applicants.fullName`	Array	Full name.	-
`applicants.fullName.text`	String	Text.	ANKER INC
`applicants.fullName.languageCode`	String	Language code.	en
`applicationDate`	String	Application date. Date or timestamp value.	2022-09-29
`applicationLanguageCode`	String	Application language code.	en
`applicationNumber`	String	Application number.	97612203
`registrationNumber`	String	Registration number.	4590785
`applicationRefNumber`	Array	Application ref number.	-
`brandName`	Array	Brand name.	[ "1ST AID"]
`collection`	String	Collection.	ustm
`designatedCountries`	Array	Designated countries.	["US"]
`designation`	Array	Designation.	["US"]
`filingPlace`	String	Filing place.	-
`kind`	Array	Kind.	["Individual"]
`logos`	Array	Logos.	-
`logos.logo`	String	Logo.	-
`logos.logoUrl`	String	Logo URL.	-
`markFeature`	String	Mark feature.	Combined
`niceClass`	Array	Nice class.	[5]
`office`	String	Office.	US
`status`	String	Status.	Pending
`statusDate`	String	Status date. Date or timestamp value.	2023-05-02
`type`	String	Type.	TRADEMARK

Response example

{
  "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"
      }
    ]
  }
}

See Errors and rate limits for error payloads, request tracing, and rate-limit headers.

Availability: Available

This endpoint is active in the v1 gateway, OpenAPI, and subscription catalog. A successful call consumes 1 billing unit.

POST /v1/global/trademarks/search

The request and response fields below match the current public contract.

Quick call

First create an API key, then store it in a server-side environment variable:

export ECOMMERCE_DATA_API_KEY="your_api_key"

curl --request POST \
  --url https://ecommercedataapi.com/v1/global/trademarks/search \
  --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
}'

Integrate with an AI CLI

Copy for your AI CLI

Paste this task into Codex, Claude Code, Gemini CLI, or another coding agent.

Integrate the "Trademark Search" endpoint from Ecommerce Data API into the current repository. Make the changes directly instead of only returning sample code.

Example request:
{
"office": [
"US"
],
"text": "ANKER",
"status": [
"Registered"
],
"order": {
"field": "applicationDate",
"desc": true
},
"page": 1,
"size": 20
}

Need an API key?Create API key

Open this request in Postman

Download the preconfigured collection for this endpoint, then import it into Postman.

Download Postman config

Set the apiKey collection variable after import.Create API key

Node.js example

const response = await fetch(
  'https://ecommercedataapi.com/v1/global/trademarks/search',
  {
    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 example

import os
import requests

response = requests.post(
    "https://ecommercedataapi.com/v1/global/trademarks/search",
    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"])

Request body

Send the fields below directly in the JSON body without an extra wrapper. Undefined fields are rejected.

Field	Type	Required	Description	Example
`applicant`	Array	No	Applicant.	["ANKER INC"]
`applicationYear`	Array	No	Application year.	["1985"]
`brandName`	Array	No	Brand name.	["ADVENTURE CLUB"]
`expiryYear`	Array	No	Expiry year.	["2026"]
`imageBase64`	String	No	Image base64.	Image base64
`niceClass`	Array	No	Nice class.	[5]
`office`	Array	No	Trademark office or list of trademark offices.	["US"]
`order`	Object	No	Sort definition.	{}
`order.desc`	Boolean	No	Use true for descending order or false for ascending order.	true
`order.field`	String	No	Field used to sort the results.	searches
`page`	Integer	No	Page number starting at 1.	1
`returnFields`	String	No	Optional comma-separated response fields. Omit it to receive the standard payload.	id,applicant,applicantCountryCode
`size`	Integer	No	Number of results per page.	20
`status`	Array	No	Status.	["Registered"]
`text`	String	Yes	Text used by the query.	CHINESE

Response structure

Field	Type	Description
`request_id`	String	Unique identifier for this request.
`data`	Object	Endpoint business data.

The fields below are inside data. For array endpoints they describe one array item; for paginated endpoints they describe one record in items[].

Response fields

Field	Type	Description	Example
`id`	String	ID.	US502022097612203
`applicant`	Array	Applicant.	ANKER INC
`applicantCountryCode`	String	Applicant country code.	US
`applicants`	Array	Applicants.	格式同office
`applicants.kind`	String	Kind.	Legal Entity
`applicants.identifier`	String	Identifier.	33744042
`applicants.countryCode`	String	Country code.	US
`applicants.contact`	Object	Contact.	-
`applicants.fullAddress`	Array	Full address.	-
`applicants.fullAddress.text`	String	Text.	-
`applicants.fullAddress.languageCode`	String	Language code.	en
`applicants.fullAddress.imageUrl`	String	Image URL.	-
`applicants.fullName`	Array	Full name.	-
`applicants.fullName.text`	String	Text.	ANKER INC
`applicants.fullName.languageCode`	String	Language code.	en
`applicationDate`	String	Application date. Date or timestamp value.	2022-09-29
`applicationLanguageCode`	String	Application language code.	en
`applicationNumber`	String	Application number.	97612203
`registrationNumber`	String	Registration number.	4590785
`applicationRefNumber`	Array	Application ref number.	-
`brandName`	Array	Brand name.	[ "1ST AID"]
`collection`	String	Collection.	ustm
`designatedCountries`	Array	Designated countries.	["US"]
`designation`	Array	Designation.	["US"]
`filingPlace`	String	Filing place.	-
`kind`	Array	Kind.	["Individual"]
`logos`	Array	Logos.	-
`logos.logo`	String	Logo.	-
`logos.logoUrl`	String	Logo URL.	-
`markFeature`	String	Mark feature.	Combined
`niceClass`	Array	Nice class.	[5]
`office`	String	Office.	US
`status`	String	Status.	Pending
`statusDate`	String	Status date. Date or timestamp value.	2023-05-02
`type`	String	Type.	TRADEMARK

Response example

{
  "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"
      }
    ]
  }
}

See Errors and rate limits for error payloads, request tracing, and rate-limit headers.

Trademark Search

API data samples

Quick call

Integrate with an AI CLI

Copy for your AI CLI

Open this request in Postman

Node.js example

Python example

Request body

Response structure

Response fields

Response example

On this page

Trademark Search

API data samples

Quick call

Integrate with an AI CLI

Copy for your AI CLI

Open this request in Postman

Node.js example

Python example

Request body

Response structure

Response fields

Response example

On this page