Token Quota Usage Query Interface Document

Interface Description

Query the SERP quota consumption summary of a token by token_id, returning total quota, remaining quota and breakdown details of each product.

Request URL: https://openapi.thordata.com/api/serp_api/token/usage_summary

Request Method: POST

Request Parameters

表格

Parameter	Type	Required	Description
token	string	Yes	Authentication credential, obtained from My Account‑API
token	string	Yes	Target token for usage query, obtained from SERP API‑API Token

CURL Example

curl --request POST \
  --url http://api-dev-test.thordata.com/api/serp_api/token/usage_summary \
  --header 'token: Your authentication token' \
  --form 'token=Target token for usage query'

Success Response Example

{
 "code": 0,
 "msg": "success",
 "data": {
 "token_id": 1024,
 "token_name": "Your TokenName",
 "flow_limit": 100000,
 "flow_used": 3200,
 "flow_remain": 96800,
 "products": [
 { "product": "serp", "flow_limit": 100000, "flow_used": 3200, "flow_remain": 96800 }
 ]
 }
}

Response Field Description

表格

Field	Type	Description
token_id	int	Token ID
token_name	string	Token name
flow_limit	int64	SERP quota cap; 0 means unlimited
flow_used	int64	Consumed SERP quota
flow_remain	int64	Remaining SERP quota; -1 means unlimited
products	array	Array of consumption breakdown per product
product	string	Product identifier