---
title: "作品列表"
method: GET
path: "/api/v2/channels/works/{platform}"
tags: ["渠道管理/作品"]
---

# 作品列表

`GET /api/v2/channels/works/{platform}`

接口说明：获取指定平台账号的作品列表

## Path parameters

- `platform` string, required

## Query parameters

- `accountId` string, required — 账号 ID
- `pagination` union — 分页参数
  - object
    - `page` integer, required — 页码
    - `pageSize` integer, required — 每页数量
  - object
    - `cursor` string, required — 分页游标
    - `limit` integer — 每页数量，不传时使用平台默认值
    - `direction` 'next' | 'previous' — 分页方向，不传时默认下一页
  - object
    - `limit` integer, required — 每页数量，不传时使用平台默认值
    - `direction` 'next' — 分页方向，不传时默认下一页
  - object
    - `direction` 'next', required — 分页方向，不传时默认下一页

## Response `200`

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

- object
  - `data` ChannelWorkListVo
    - `platform` 'douyin' | 'xhs' | 'wxSph' | 'KWAI' | 'youtube' | 'wxGzh' | 'bilibili' | 'twitter' | 'tiktok' | 'facebook' | 'instagram' | 'threads' | 'pinterest' | 'linkedin' | 'google_business', required — 平台
    - `items` object[], required — 作品列表
      - `platformWorkId` string, required — 平台作品 ID
      - `contentMode` 'article2' | 'article' | 'video', required — 作品内容类型
      - `title` string — 作品标题
      - `description` string — 作品描述
      - `url` string — 作品链接
      - `coverUrl` string — 封面 URL
      - `publishedAt` string, date-time — 发布时间
      - `authorName` string — 作者名称
      - `authorPlatformUid` string — 作者平台 UID
      - `status` string — 作品状态
      - `metrics` object — 作品指标
        - `viewCount` number — 浏览数
        - `playCount` number — 播放数
        - `impressionCount` number — 曝光数
        - `reachCount` number — 触达数
        - `likeCount` number — 点赞数
        - `collectCount` number — 收藏数
        - `commentCount` number — 评论数
        - `shareCount` number — 分享数
        - `saveCount` number — 保存数
        - `clickCount` number — 点击数
        - `engagementCount` number — 互动数
        - `watchTimeSeconds` number — 观看时长秒数
    - `pagination` union, required — 分页结果
      - object
        - `mode` 'cursor', required — 分页模式
        - `nextCursor` string — 下一页游标
        - `previousCursor` string — 上一页游标
        - `hasNext` boolean, required — 是否有下一页
        - `hasPrevious` boolean, required — 是否有上一页
        - `limit` integer, required — 每页数量
      - object
        - `mode` 'page', required — 分页模式
        - `page` integer, required — 页码
        - `pageSize` integer, required — 每页数量
        - `total` integer — 总数
        - `hasNext` boolean, required — 是否有下一页
        - `hasPrevious` boolean, required — 是否有上一页
      - object
        - `mode` 'none', required — 分页模式
  - `code` integer, required — 业务状态码。0 表示成功，非 0 表示业务错误。
  - `message` string, required — 响应消息。
  - `requestId` string — 请求 ID。
  - `timestamp` integer — 错误响应时间戳，Unix 毫秒。

---

[API](https://skmtc.net/aitoearn/apis/aitoearn-api.md) · [All operations](https://skmtc.net/aitoearn/apis/aitoearn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aitoearn/aitoearn-api/versions/19d860d9260d/schema)