Trademark Alert API

Trademark Alert API Highlight

The Trademark Alert API enables you to monitoring registrations that contain a trademarked word or similar product phrase.

Parameters of the Trademark Alert API

Name required? Description Default Authorized Example
exclude no Domain names with these words will be excluded from the result set. Separate multiple terms with the pipe character ( | ).

exclude=abc|123
domain_status no Sets the scope of domain names to search. Both new domain names and domains which are now on-hold (pending delete) new, on-hold domain_status=new
days_back no Use this parameter in exceptional circumstances where you need to search domains registered up to six days prior to the current date.
[1-6] days_back=3

JSON

Request

Show/Hidden apache code

View source
 
 
 
  GET /encrypted-area HTTP/1.1
  Host: api.domainapi.com/v1/trademark_alert/example
  Authorization: Basic YWtpcmE6N3hFNDBEYlFTWA==
 

Response

Show/Hidden javascript code

View source
 
 
 
  {
    "service":"trademark_alert",
    "domain":"example",
    "timestamp":1234567890,
    "content": {
      "trademarkAlert": {
        "limit":"1000",
        "total":"8",
        "new":"1",
        "on-hold":"1",
        "query":"example",
        "exclude":"",
        "alertsList":[
          {
            "status":"new",
            "domain":"bitcoinexample.com"
          },
          {
            "status":"new",
            "domain":"bitcoinexamples.com"
          },
 
          ...
 
	  {
            "status":"on-hold",
            "domain":"travelexample.com"
          }
        ],
        "date":"0000-00-00"
      }
    }
  }
 

XML

Request

Show/Hidden apache code

View source
 
 
 
  GET /encrypted-area HTTP/1.1
  Host: api.domainapi.com/v1/trademark_alert/xml/example
  Authorization: Basic YWtpcmE6N3hFNDBEYlFTWA==
 
 

Additional information