> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/doc/scraping/serp-api/query-parameters/token-quota-usage-query-interface-document.md).

# 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>&#x20;

**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                         |