Making requests | Documentation | Brand Alert API | Whois XML API

Making requests

It takes up to a minute to activate your account after the registration.

POST request body sample

    "apiKey": "YOUR_API_KEY",
    "sinceDate": "2020-05-18",
    "mode": "purchase",
    "withTypos": false,
    "responseFormat": "json",
    "includeSearchTerms": [
    "excludeSearchTerms": [



You can use this header or apiKey parameter for API calls.

Get your personal API KEY on My products page.

Input parameters


Required. Get your personal API KEY on My products page.


Required. Array of search terms which should be present in the domain name. Maximum 4 items. Case insensitive.


Optional. Array of search terms which should NOT be present in the domain name. Maximum 4 items. Case insensitive.


Optional. Date in "YYYY-MM-DD" format.

Allowed dates are in the [Today minus 14 days — Today] interval.

Yesterday's date by default.

If present, search through activities discovered since the given date. Sometimes there is a latency between the actual added/renewal/expired date and the date when our system detected this change. We recommend using this field in your monitoring tools for filtering daily changes.



preview – return only the number of domains. No credits deducted.

purchase – return the actual list of domains (limited to 10,000). 1 request costs 10 DRS credits.

Acceptable values: preview | purchase

Default: preview


Optional. If true, the search terms set will be enriched with their possible typos. For example, for the term 'google', the typos might be: 'goigle', 'gokgle', 'golgle', 'gopgle', 'goglee', 'gooogle' etc.

Acceptable values: false | true

Default: false

With typos included - 1 request costs 1,000 DRS credits.

Learn more: Typo generation FAQ


Optional. Response output format.

Acceptable values: json | xml

Default: json

Free access

After Sign Up you automatically get a free subscription plan limited to 100 DRS credits per month.

Usage limits and requests throttling

The maximum number of requests per second is 30. In case that the limit is breached, your subsequent requests will be rejected until the next second.

Have questions?

We work hard to improve our services for you. As part of that process, we welcome your feedback, questions, and suggestions. Please let us know about your thoughts and feelings, and any way in which you think we can improve our product.

For a quick response, please select the request type that best suits your needs. For more info regarding the request types, see Contact us page.

By submitting, you agree to the Terms of Service and Privacy Policy.

Or shoot us an email to