> For the complete documentation index, see [llms.txt](https://doc.thordata.com/interface-documentation/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/interface-documentation/zh-hk/gong-gong-api/dai-li-yong-hu/an-xiao-shi-cha-xun-liu-liang-shi-yong-ji-lu.md).

# 按小时查询流量使用记录

### 基礎信息

**接口說明：**通過接口獲取Thordata住宅代理、無限代理伺服器、移動代理用戶流量使用日誌

**請求地址：**<https://openapi.thordata.com/api/proxy-users/usage-statistics-hour>

**請求方式：**<mark style="color:green;">GET</mark>

### 請求參數

**Params：**

<table><thead><tr><th>參數名稱</th><th>參數类型</th><th width="153">是否必須</th><th>描述</th></tr></thead><tbody><tr><td><code>token</code></td><td>string</td><td>必須</td><td>請登入<a href="https://dashboard.thordata.com/account-settings"><strong>儀表板 >> 菜單 >> 我的賬戶</strong></a>查看您的token參數值</td></tr><tr><td><code>proxy_type</code></td><td>number</td><td>必須</td><td>選擇代理類型：1是住宅代理，2是無限代理伺服器，3移動代理（默認為1）</td></tr><tr><td><code>username</code></td><td>string</td><td>必須</td><td>需要查詢的代理用戶名</td></tr><tr><td><code>from_date</code></td><td>string</td><td>必須</td><td>開始查詢日期，格式：yyyy-mm-dd HH</td></tr><tr><td><code>to_date</code></td><td>string</td><td>必須</td><td>結束查詢日期，格式：yyyy-mm-dd HH</td></tr></tbody></table>

### 響應示例

```json
{
    "code": 200,
    "data": {
        "traffic_limit": 0,
        "total_usage_traffic": 332,
        "traffic_balance": 0,
        "query_days": 35,
        "range_usage_traffic": 355509206,
        "data": [
            {
                "date": "2025-07-01 00",
                "usage_traffic": 4719123.98
            },
            {
                "date": "2025-07-01 01",
                "usage_traffic": 14928258.7
            },
            {
                "date": "2025-07-01 02",
                "usage_traffic": 12096429.29
            }
        ]
    },
    "msg": "ok"
}
```

{% hint style="info" %}
若返回的code值非200，請查閱[**錯誤碼說明**](/interface-documentation/zh-hk/cuo-wu-ma/cuo-wu-ma-shuo-ming.md)列表並進行修改
{% endhint %}

<table><thead><tr><th width="243">参数名稱</th><th>参数類型</th><th width="113">是否必須</th><th>描述</th></tr></thead><tbody><tr><td><code>code</code></td><td>number</td><td>非必須</td><td>-</td></tr><tr><td><code>data</code></td><td>object</td><td>非必須</td><td>-</td></tr><tr><td><code>traffic_limit</code></td><td>number</td><td>必須</td><td>流量限制（kb），0為不限制</td></tr><tr><td><code>total_usage_traffic</code></td><td>number</td><td>必須</td><td>總使用流量（kb）</td></tr><tr><td><code>traffic_balance</code></td><td>number</td><td>必須</td><td>剩餘流量（kb）</td></tr><tr><td><code>query_days</code></td><td>number</td><td>必須</td><td>查詢天數</td></tr><tr><td><code>range_usage_traffic</code></td><td>number</td><td>必須</td><td>查詢日期內的總使用流量（kb）</td></tr><tr><td><code>date</code></td><td>string</td><td>必須</td><td>日期</td></tr><tr><td><code>usage_traffic</code></td><td>number</td><td>必須</td><td>當天使用流量（kb）</td></tr><tr><td><code>msg</code></td><td>string</td><td>非必須</td><td>-</td></tr></tbody></table>