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

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"
}