DomainTools API Guide: Brand Alert

The DomainTools API is organized into distinct products with queries that follow a REST-ful URL structure wherever possible. Each product offers free, un-authenticated access for the sample URLs listed with each product. If you haven't already, you may want to review the getting started document to learn about authentication and response formats.

The Brand Alert API searches new .com, .net, .org, .info, .biz, and .us domain names for specific terms. The product is ideal for monitoring registrations that contain a trademarked word or similar product phrase.

  http://api.domaintools.com/v1/mark-alert/?query=domaintools
	

NOTE: We are unable to provide a functioning test URL for this product because the data changes each day as domain names are registered, placed on-hold, or deleted. See below for a sample response.

By default, the active data set is the list of domain names registered on the day you submit your API query. You should design your system to submit one API query per day for each term you want to monitor. If you experience a temporary failure in your processing routines, you can catch up on missing alerts up to six days back by providing the days_back parameter in your request.

For best results, schedule your daily update to occur no sooner than 3am Pacific time. This ensures the data has been fully processed and is ready for your use. If the data is not ready when you submit your query, you'll receive an error message and your account will not be charged.

Because each query consumes resources regardless of whether a match is found, your API account will be charged for each request you submit to the API even if no domain names match your query.

Sample Response

   response: {
     query: "finance",
     exclude: "auto|best",
     new: true,
     on-hold: true,
     date: "2011-03-02",
     total: 2,
     alerts: [
       {
         domain: "24hourfinance.info",
         status: "on-hold"
       },
       {
         domain: "actionis-finance.com",
         status: "new"
       }
     ]
   }