# Douyin-App/抖音APP - 批量获取作品统计数据V2（含投流/广告加热的总播放量）

所属目录：Douyin-App/抖音APP

文档地址：https://doc.getoneapi.com/503961213e0

`POST https://api.getoneapi.com/api/douyin-app/fetch_multiple_video_statistics_v2`

- 批量获取视频(item)的播放量等统计与详情，一次最多20个，节省调用次数
- 每条含 stats（watch_cnt 播放量 / like_cnt 点赞 / comment_cnt 评论 / share_cnt 转发 /favorite_cnt 收藏 / interact_rate 互动率 / avg_watch_dura 人均观看时长）及视频详情
- 注意：watch_cnt 为含投流(广告加热)的总播放量，并附带作品详情；如需未投流(自然)播放量，请调用[批量获取作品统计数据（包含播放数（自然播放量））](https://doc.getoneapi.com/393579312e0)
- 不足20也按20算，建议尽量凑满20个再请求
- 价格：1.00 / 次（= 20 × 单个 0.05）

## 鉴权

在请求头中传递 Authorization: Bearer YOUR_API_KEY（必填）

## 请求参数

### Header 参数

| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| Authorization | string | 是 | 在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 apikey<br><br>默认值： Bearer YOUR_API_KEY |
| Content-Type | string | 是 | 默认值： application/json |

### Body 参数 · application/json

| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| aweme_id | array&lt;string&gt; | 是 | 视频ID数组（最多20个） |
| aweme_id.items | string | 否 |  |

#### JSON Schema

```json
{
  "type" : "object",
  "properties" : {
    "aweme_id" : {
      "type" : "array",
      "items" : {
        "type" : "string"
      },
      "description" : "视频ID数组（最多20个）"
    }
  },
  "required" : [ "aweme_id" ]
}
```

#### 示例

```json
{
  "aweme_ids" : [ "7584380037021830400", "7584380037021830400" ]
}
```

## 返回响应

### 响应 200 · application/json

| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| code | integer | 是 |  |
| message | string | 是 |  |
| data | object | 是 |  |

#### JSON Schema

```json
{
  "type" : "object",
  "properties" : {
    "code" : {
      "type" : "integer"
    },
    "message" : {
      "type" : "string"
    },
    "data" : {
      "type" : "object",
      "properties" : { }
    }
  },
  "required" : [ "code", "message", "data" ]
}
```

#### 示例

```json
{
  "code" : 200,
  "message" : "success",
  "data" : { }
}
```

## 请求示例代码

```sh
curl --globoff --request POST 'https://api.getoneapi.com/api/douyin-app/fetch_multiple_video_statistics_v2' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "aweme_ids" : [ "7584380037021830400", "7584380037021830400" ]
}'
```

