> For the complete documentation index, see [llms.txt](https://bitlong.gitbook.io/api-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bitlong.gitbook.io/api-doc/tapd-api/userstats.md).

# UserStats

### 1.用户活跃数

*每个Nostr地址每天只计算一次*

**该数据记录从2024-11-14开始**

#### 请求

<mark style="color:green;">`GET`</mark> `/user_stats/count`

示例

/user\_stats/count?<mark style="color:orange;">start</mark>=<mark style="color:blue;">2024-11-14</mark>&<mark style="color:orange;">end</mark>=<mark style="color:blue;">2024-11-14</mark>

#### 参数

* `start` <mark style="color:green;">"2006-01-02"</mark>
* `end` <mark style="color:green;">"2006-01-02"</mark>

#### 响应

```json
{
    "errno": 200,
    "errmsg": "",
    "data": 1951
}
```

### 2.用户活跃IP记录

*每个Nostr地址每天使用的每个IP都会记录一次*

**该数据记录从2024-11-13开始**

#### 请求

<mark style="color:green;">`GET`</mark> `/user_stats/record`

示例

/user\_stats/record?<mark style="color:orange;">start</mark>=<mark style="color:blue;">2024-11-13</mark>&<mark style="color:orange;">end</mark>=<mark style="color:blue;">2024-11-14</mark>&<mark style="color:orange;">page</mark>=<mark style="color:blue;">1</mark>&<mark style="color:orange;">size</mark>=<mark style="color:blue;">3</mark>

#### 参数

* `start` <mark style="color:green;">"2006-01-02"</mark>
* `end` <mark style="color:green;">"2006-01-02"</mark>
* `page` 页数
* `size` 条数
* `new` 若为<mark style="color:green;">1</mark>，则为新用户信息
* `download` 若为<mark style="color:green;">1</mark>，则下载`start`到`end`期间的所有csv数据(`new`可选)，此时`page`和`size`无效

下载返回值

```json
{
    "errno": 0,
    "errmsg": "",
    "data": {
        "link": "/download/csv?name=records-new-user.csv&captcha=REcpJHCOzMD6lsvvjqzj7qr9auuHA49xhQZJe3Bq0Ucru5viNpyvOyPhIrYmWwA8"
    }
}
```

#### 响应

```json
{
    "errno": 200,
    "errmsg": "",
    "data": {
        "records": [
            {
                "username": "npub33Vweubaq2eAQaFiSfbQ1Ck2ozpLNuLnJnBtpTvrAVDGmCyKAebjxe9GmUxWXVCWvXimAaBhaywqhSTVuRaKKGtm",
                "date": "2024-11-13",
                "ip": "171.212.112.253"
            },
            {
                "username": "npub2zFJoxZv2n8yZt3usJ3VjpTFy1gKU2CLMFo64vM4qzRyEaApbxSwdKLighWTih86k9cgaipHy3kwYGi5DKmG2KGn",
                "date": "2024-11-13",
                "ip": "117.177.197.143"
            },
            {
                "username": "npub29YExxDrbAsefuiSbmXkToXee5j4xM8rpf6vCCFaK3eAbgYh4V2MGKLVbbGUxtPj7qZsC5weHCw7vy5xA83ZhVy6",
                "date": "2024-11-13",
                "ip": "223.104.67.133"
            }
        ],
        "total_page": 2156
    }
}
```

### 3.新用户数

**该数据记录从2024-07-01开始**

#### 请求

<mark style="color:green;">`GET`</mark> `/user_stats/new_count`

示例

/user\_stats/new\_count?<mark style="color:orange;">start</mark>=<mark style="color:blue;">2024-07-01</mark>&<mark style="color:orange;">end</mark>=<mark style="color:blue;">2024-11-14</mark>

#### 参数

* `start` <mark style="color:green;">"2006-01-02"</mark>
* `end` <mark style="color:green;">"2006-01-02"</mark>

#### 响应

```json
{
    "errno": 200,
    "errmsg": "",
    "data": 144567
}
```