Dynadot Auction API (Beta)

Our Dynadot Auction API is a powerful tool to help you make the most of our domain marketplace. The API allows you to get auction details and place bids on our expired domain auctions, backorders and user auctions. With a few simple API calls you can get the most out of the Dynadot aftermarket! Our Marketplace API is available to all accounts, so get started today!

Getting Started With Our Dynadot Auction API

Requests to our Dynadot Auction API are sent to the following URL:

https://www.dynadot.com/auction-api/{command}

Обратите внимание, что в целях безопасности запросы должны отправляться через https (защищенное соединение). В каждый момент времени может быть обработан только 1 запрос, поэтому прежде чем посылать новый запрос, подождите пока завершится текущий. Запрос должен включать в себя следующие параметры:

Параметр запросаПояснение

Параметр запроса
Пояснение

api_keyВаш ключ доступа к API, его можно найти в контрольной панели учетной записи.

commandThe commands supported right now are "get-auction-list" , "get-auction-item","place-auction-bid" and "get-auction-bids"

currency(optional)You can decide which currency to display auction data and this parameter supported are "USD","CNY", "GBP","EUR","INR","CAD" and so on.If you missed this parameter,we will use USD acquiescently

The results are sent as a json text.

Поле результатаПояснение

Поле результата
Пояснение

statusРезультат этого вызова API:
success - команда выполнена
error - команда не выполнена

contentПодробности результата выполнения команды, это поле используется только при результате "error"

Get Auction List Command

If calling the "get auction list" command, the following parameters should be included:

Get Auction List Request ParameterПояснение

Get Auction List Request Parameter
Пояснение

auction_typeThe auction type you want to request,now supported are "expired","user","backorder".You can request one or more auction types.If there are more than two types, you must use "," to split each auction type

Для запрошенного списка торгов будет много (many) результатов. У каждого лота будут перечисленные ниже поля

Get Auction List Result FieldПояснение

Get Auction List Result Field
Пояснение

auction_idThe auction_id parameter, for example: 1

domainThe domain name of this auction, for example: domain-haha1.cn

utf_nameThe utf domain name of this auction, for example: domain-haha1.cn

is_idnIf this domain is international domain name, for example: false

auction_typeThe type of this auction, for example: expired

currencyThe current price currency , for example: USD

current_bid_priceThe current bid price for this auction, for example: 28.99

bidsThe bid times about this auction, for example: 5

biddersThe amount of people who take part in this auction bid, for example: 3

time_leftThe remaining time of this auction, for example: 11 hours, 30 min

start_timeThe start time of this auction, for example: 2019/02/13 05:00 PST

start_time_stampThe start time stamp of this aucion, for example: 1550062850113

end_timeThe end time of this auciton, for example: 2019/02/20 05:00 PST

end_time_stampThe end time stamp of this auction, for example: 1550667650113

visitorsThe amount of visitors, for example: 40

linksThe amount of links, for example: 365

ageThe age about this domain, for example: 2

estibot_appraisalThe price on estibot_appraisal for this domain, for example: $388.03

Get Auction List Example

Запрос

https://www.dynadot.com/auction-api/get-auction-list?api_key=MY_API_KEY&auction_type=expired

Ответ

{

"status": "success",

"auction_list": [

{

"auction_id": 1,

"domain": "domain-haha1.cn",

"utf_name": "domain-haha1.cn",

"is_idn": false,

"auction_type": "expired",

"currency": "USD",

"current_bid_price": "57.99",

"bids": 41,

"bidders": 10,

"time_left": "11 hours, 30 min",

"start_time": "2019/02/13 05:00 PST",

"start_time_stamp": 1550062850113,

"end_time": "2019/02/20 05:00 PST",

"end_time_stamp": 1550667650113,

"visitors": 50,

"links": 35,

"age": 2,

"estibot_appraisal": "$388.03",

{ /* expired-auction2 data */},

{ /* expired-auction3 data */},

...

Get Auction Item Command

If calling the "get auction Item" command, the following parameters should be included:

Get Auction Item Request ParameterПояснение

Get Auction Item Request Parameter
Пояснение

domainThe auction details you want to request by domain to get

There will be 1 result for auction by domain under you request. The auction details will have some new fields compared with list conmand as below.The command now are supported auctions that have not ended and have ended within 1 hour

Поле результата команды получения сведений о лотеПояснение

Поле результата команды получения сведений о лоте
Пояснение

accepted_bid_priceThe acceptable price to bid at this auction, for example: 33.99

is_high_bidderIf you are the high bidder, for example: true

auction_endedIf the auction has ended, for example: false

customer_bidedIf you has take part in this auction, for example: true

customer_bidYour bid price, for example: 33.99

customer_proxy_bidYour proxy_bid price , for example: $100

bidder_nameThe name of the bidder, for example: bidder 1

bid_priceThe amount of this bid, for example: 35.99

timestampThe timestamp when the bidder bid at this auction, for example: 1550637925300

bid_statusYour status at this auction,"high bidder" means you are the highest bidder,, for example: High Bidder

is_proxy_auto_bidIf this bid is proxy_bid, for example: false

Get Auction Item Example

Запрос

https://www.dynadot.com/auction-api/get-auction-item?api_key=MY_API_KEY&domain=domain-haha1.cn

Ответ

{

"status": "success",

"auction_json":

{

"auction_id": 1,

"domain": "domain-haha1.cn",

"utf_name": "domain-haha1.cn",

"is_idn": false,

"auction_type": "expired",

"accepted_bid_price": "57.99",

"currency": "USD",

"is_high_bidder": false,

"current_bid_price": "57.99",

"bids": 41,

"bidders": 10,

"time_left": "11 hours, 30 min",

"start_time": "2019/02/13 05:00 PST",

"start_time_stamp": 1550062850113,

"end_time": "2019/02/20 05:00 PST",

"end_time_stamp": 1550667650113,

"visitors": 50,

"links": 35,

"age": 2,

"estibot_appraisal": "$388.03",

"auction_ended": false,

"customer_bided": true,

"costomer_bid": "27.99",

"customer_proxy_bid": "$159.00",

"bid_history": [

{

"bidder_name": "bidder 1",

"bid_price": "$159.00",

"currency": "USD",

"timestamp": "1550667650113",

"bid_status": "High Bidder",

"is_proxy_auto_bid": "false"

}

{ /* bid history2 data */},

{ /* bid history3 data */},

...

Команда регистрации ставки на аукционный лот

If calling the "Place Auction Bid" command, the following parameters should be included:

Параметр запроса на регистрацию ставки на аукционный лотПояснение

Параметр запроса на регистрацию ставки на аукционный лот
Пояснение

domainThe domain of the auction you want to place bid on

bid_priceThe amount you want to bid, in dollar. e.g. 85.99

If your bid is successful.There will be 1 result for auction is similar to get-auction-item command.

Пример регистрации ставки на аукционный лот

Запрос

https://www.dynadot.com/auction-api/place-auction-bid?api_key=MY_API_KEY&domain=domain-haha1.cn&bid_price=100

Ответ

{

"status": "success",

"auction_json":

{

"auction_id": 1,

"domain": "domain-haha1.cn",

"utf_name": "domain-haha1.cn",

"is_idn": false,

"auction_type": "expired",

"accepted_bid_price": "57.99",

"currency": "USD",

"is_high_bidder": false,

"current_bid_price": "57.99",

"bids": 41,

"bidders": 10,

"time_left": "11 hours, 30 min",

"start_time": "2019/02/13 05:00 PST",

"start_time_stamp": 1550062850113,

"end_time": "2019/02/20 05:00 PST",

"end_time_stamp": 1550667650113,

"visitors": 50,

"links": 35,

"age": 2,

"estibot_appraisal": "$388.03",

"auction_ended": false,

"customer_bided": true,

"costomer_bid": "27.99",

"customer_proxy_bid": "$159.00",

"bid_history": [

{

"bidder_name": "bidder 1",

"bid_price": "$159.00",

"currency": "USD",

"timestamp": "1550667650113",

"bid_status": "High Bidder",

"is_proxy_auto_bid": "false"

}

{ /* bid history2 data */},

{ /* bid history3 data */},

...

Get Auction Bids Command

Get Auction Bids Result FieldПояснение

Get Auction Bids Result Field
Пояснение

bid_idIf your request is successful.There will be some bids you have taken part in.There will be some fields as belowThe id for this bid, for example: 15

auction_idThe id for this auction, for example: 5

account_idThe id for this account, for example: 3

domainThe domain for this auction, for example: domain-haha1.com

domain_utfThe domain_utf for this auction, for example: domain-haha1.com

auction_typeThe auction type for this auction , for example: expired

is_idnIf this domain is international, for example: false

current_bidThe current bid price for this auction, for example: $33.99

your_statusYour bid status at this auction, for example: High Bidder

proxy_bidYour proxy bid price, for example: $37.99

active_biddersThe amount of bidders at this domain auction , for example: 10

~~ends_onThe end time for the auction, for example: Feb 20, 2019 10:00am PST~~

end_timeThe end time of this auciton, for example: 2019/02/20 05:00:00 PST

end_time_stampThe end time stamp of this auction, for example: 1550667650113

If your request is successful,there will be some results as you see in the example section.

Get Auction Bids Example

Запрос

https://www.dynadot.com/auction-api/get-auction-bids?api_key=MY_API_KEY

Ответ

{

"status": "success",

"auction_bids": [

{

"bid_id": 1,

"auction_id": 1,

"account_id": 1,

"domain": "domain-haha1.cn",

"domain_utf": "domain-haha1.cn",

"auction_type": "expired",

"is_idn": false,

"current_bid": "$57.99",

"proxy_bid": "$85.88",

"your_status": "High Bidder",

"active_bidders": 10,

"time_left": "11 hours, 30 min",

"ends_on": "2019/02/20 05:00 PST",

"end_time": "2019/02/20 05:00:00 PST",

"end_time_stamp": "1554774971733",

{ /* bid2 data */},

{ /* bid3 data */},

...