---
title: "获取达人直播统计V1/Get Author Live Statistics V1"
method: GET
path: "/api/v1/douyin/xingtu/author_live_statistics_v1"
tags: ["Douyin-Xingtu-API"]
---

# 获取达人直播统计V1/Get Author Live Statistics V1

`GET /api/v1/douyin/xingtu/author_live_statistics_v1`

## Request

- Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tikhub.io/api/v1/douyin/xingtu/author_live_statistics_v1`
- Auth: HTTP bearer

# [中文]
### 用途:
- 获取达人的直播统计数据
- 该接口数据使用企业账号进行请求，收费较贵。
- 价格：0.02$ / 次
### 参数:
- oAuthorId: 星图达人ID, 可以从接口以下接口获取：
    - `/api/v1/douyin/xingtu/get_xingtu_kolid_by_uid`
    - `/api/v1/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`
    - `/api/v1/douyin/xingtu/get_xingtu_kolid_by_unique_id`
- liveType (可选): 直播类型, 支持 ALL(全部) / GAME(游戏) / ECOMMERCE(电商) / OTHER(其他)
- period (可选): 时间范围, 支持 DAY_30(近30天) / DAY_90(近90天)
- onlyStarOrder (可选): 是否仅统计星图订单, true / false
- flowType (可选): 流量类型, 支持 EXCLUDE / INCLUDE
- 以上参数均可不传，不传时使用上游默认值
### 返回:
- 达人直播统计数据

# [English]
### Purpose:
- Get the author's live-streaming statistics
- The interface data is requested using an enterprise account, which is more expensive.
- Price: 0.02$ / time
### Parameters:
- oAuthorId: Xingtu author id, can be obtained from the following interfaces:
    - `/api/v1/douyin/xingtu/get_xingtu_kolid_by_uid`
    - `/api/v1/douyin/xingtu/get_xingtu_kolid_by_sec_user_id`
    - `/api/v1/douyin/xingtu/get_xingtu_kolid_by_unique_id`
- liveType (optional): Live type, ALL / GAME / ECOMMERCE / OTHER
- period (optional): Time period, DAY_30 / DAY_90
- onlyStarOrder (optional): Whether to count Xingtu orders only, true / false
- flowType (optional): Flow type, EXCLUDE / INCLUDE
- All of the above are optional and fall back to the upstream defaults
### Return:
- Author live-streaming statistics

# [示例/Example]
oAuthorId = "7048929565493690398"
liveType = "ALL"
period = "DAY_30"

## Query parameters

- `oAuthorId` string, required: 星图达人ID/Xingtu Author ID
- `liveType` string: 直播类型(可选)/Live Type (optional)
- `period` string: 时间范围(可选)/Time Period (optional)
- `onlyStarOrder` string: 是否仅星图订单(可选)/Only Xingtu orders (optional)
- `flowType` string: 流量类型(可选)/Flow Type (optional)

## Response `200`

Successful Response

- ResponseModel
  - `code` integer: HTTP status code | HTTP状态码
  - `request_id` string, nullable: Unique request identifier | 唯一请求标识符
  - `message` string: Response message (EN-US) | 响应消息 (English)
  - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文)
  - `support` string: Support message | 支持消息
  - `time` string: The time the response was generated | 生成响应的时间
  - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳
  - `time_zone` string: The timezone of the response time | 响应时间的时区
  - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接
  - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English)
  - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文)
  - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL
  - `router` string: The endpoint that generated this response | 生成此响应的端点
  - `params` unknown
  - `data` unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-09** `cd87023a7e18`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/douyin/xingtu/author_live_statistics_v1/get.md)

---

[API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)
