GNAME | API Services: Integrate without extensive development

List of All Biddings

Parameter description:

sortby	Please refer to Appendix [Sorting Fields] for details
category	Please refer to Appendix [Domain Category Fileds] for details
style	Please refer to Appendix [Domain Style Fileds] for details
delete_type	Please refer to Appendix [Delete Type Fileds] for details

Request URL

/api/bid/list

Request Method

POST

Request Parameter

Field	Parameter	Type	Required	Description
APPID	appid	String	Yes	Application Client Id
Timestamp	gntime	String	Yes	The current UNIX timestamp
Signature	gntoken	String	Yes	Signature string. For details, please refer to the Signature Method page.
Domain include	inc_value	String	No	The domain name contains content, separated by multiple [,]
Domain include start	inc_start	String	No	Default=0, 1=includes, 0=not includes
Domain include end	inc_end	String	No	Default=0, 1=includes, 0=not includes
Domain exclusion	exc_value	String	No	Domain exclusion content
Domain exclusion start	exc_start	Integer	No	Default=0, 1=excludes, 0=not exclude
Domain exclusion end	exc_end	Integer	No	Default=0, 1=excludes, 0=not exclude
Domain TLD	tld	String	No
Domain category	category	String	No
Domain special style	style	String	No
Minimum bid amount	price_min	Float	No	0.00
Maximum bid amount	price_max	Float	No	200.00
Deletion Type	deletion_type	Integer	No	1
Minimum domain length	len_min	Integer	No
Maximum domain length	len_max	Integer	No
Minimum registration year	reg_year_min	Integer	No
Maximum registration year	reg_year_max	Integer	No
Minimum historical rating	ha_min	Integer	No
Maximum historical rating	ha_max	Integer	No
Minimum domain authority	da_min	Integer	No
Maximum domain authority	da_max	Integer	No
Minimum page authority	pa_min	Integer	No
Maximum page authority	pa_max	Integer	No
Result sorting	sortby	String	No	Format: Sort_field, Example: asc_price, desc_price
Page	page	Integer	No	1
Page size	pagesize	Integer	No	50
End time	end_time	String	No	2022-06-01 12:34:56~2022-06-02 12:34:56
History of website status	website_history	Integer	No	1=exists, 99=does not exist
Website language	website_lang	String	No	zhcn=Chinese, us=English, other=Other
Minimum website score	website_score_min	Integer	No
Maximum website score	website_score_max	Integer	No
Minimum website record	website_record_min	Integer	No
Maximum website record	website_record_max	Integer	No
Minimum google record	google_record_min	Integer	No
Maximum google record	google_record_max	Integer	No

Response Data

Field	Parameter	Type	Description
return code	code	Integer	1：return successfully -1：return failed
return description	msg	String	return the description of request operation
return data	data	Array	return the requested operation result data
Total number of records	count	Integer
Page number	page	Integer
Page size	pagesize	Integer

Return Data

Field	Parameter	Description
auction ID	id
domain	domain
end time	end_time
time left	time_left	How many seconds are left until the end time
auction status	status
auction status description	status_desc
whether leading	lead_status	Leading status: 1high bid\|0out bid
lead UID	lead_uid	The UID of the current bidding leader
backorder status	is_backorder	Has it been backordered,1=Yes,0=No
Price status	price_status	1=equal 2=approximately equal 3=confidential
Current price	price
Price increase amount	price_incr	Price increase amount
Minimum bid amount	lower_bid
place into fee	breakin_fee
Deposit	deposit	fees that need to be frozen for bidding
Deposit rate	deposit_rate	Deposit rate
Proxy bidding amount	proxy_bid
Frozen amount	frozen_amount
Deletion Type	deletion_type
Deletion Typename	deletion_typename

Response Demo

//Successful Response Data
{
    "code": 1,
    "msg": "OK",
    "data": [
{
	"id": "767",
	"domain": "example.net",
	"end_time": "2022-05-07 21:30:01",
	"time_left": 0,
	"status": 0,
	"status_desc": "In auction",
	"lead_status": 0,
	"lead_uid": 123456,
	"is_backorder": 0,
	"price_status": 2,
	"price": "28.00",
	"price_incr": "5.00",
	"lower_bid": "33.00",
	"breakin_fee": "0.00",
	"deposit": "8.40",
	"deposit_rate": "0.2",
	"proxy_bid": "139.20",
	"frozen_amount": "27.84",
	"deletion_type": "1",
	"deletion_typename": "Delete",
}
    ],
    "count": 100,
    "sortby": 0,
    "page": 1,
    "pagesize": 1
}


//Failed Response Data
{
	"code": -1, 
	"msg": "No permission"
}