API for intercepting dropping domains
Attention!
At the moment we intercept only .com and .net. Other zones in the near future. We will notify you by e-mail.
1. General information
- this API works on the same principles as our main API. Read about our main API you can here;
- do not try to intercept domains using the main API, strict limitations also have been enacted for frequent requests. For violations user will be banned;
- interception is available for all our users and works on the auction principle: whose bid is higher than keeps the domain in case of interception;
- when the request to intercept the domain is sending, it checking if there enough funds at the account. The required cost for registration in the proper zone and bid amount reserved. If the domain was not intercepted, funds will be returned with some delay, but surely;
- we send a lot of requests to registrar of zone with all available frequency to intercept domain. You just have to make a request for desired domain name with your bid;
- available frequency of requests for interception is using proportional to the amount of the bet;
- for example: domain1 - bet is $ 1, domain2 - bet is $ 100. Requests for domain2 will be sent 100 times more than domain1;
- Good luck!
2. Detailed examples
| Command |
Description |
Arguments |
Return values |
| domainIntercept |
Request domain intercept |
- domain — domain, *
- bid — money, *; amount greater than zero, in dollars
|
- domain — domain
- bid — current (maximum) rate at the moment
- got — '1' if domain is yours, in other case 'null'
|
| domainsIntercept |
Request multiple domains intercept |
- array of — domainIntercept
|
- array of — domainIntercept
|
Example: domainIntercept
/domainIntercept?auth_login=demo&auth_password=demo&domain=test.com&bid=1
Example of answer 1:
{"id":1414054,"domain":"test.com","bid":1,"got":"1"}
- bid=1 — current (maximum) rate at the moment — $1;
- got='1' — the domain is yours at this moment — your bid is maximum for the present;
Example of answer 2:
{"id":1414054,"domain":"test.com","bid":2,"got":""}
- bid=2 — current (maximum) rate at the moment — $2;
- got=null — the domain is in someone else. Please, increase your bid minimum to: bid+0.01=2.01;
Example of answer 3:
{"id":1414054,"domain":"test.com","bid":1,"got":""}
- bid=2 — the maximum current rate is $1 as same as your, but the domain is not yours as you bid later;
- got=null — the domain is in someone else. Please, increase your bid minimum to: bid+0.01=1.01;
Example: domainsIntercept
/domainsIntercept?auth_login=demo&auth_password=demo&0[domain]=test1.com&0[bid]=1&1[domain]=test2.com&1[bid]=1