---
title: "账号列表"
method: GET
path: "/api/v2/channels/accounts"
tags: ["渠道管理/账号"]
---

# 账号列表

`GET /api/v2/channels/accounts`

接口说明：分页获取当前用户的渠道账号列表。

## Query parameters

- `ids` string[] — 账号 ID 数组
- `types` string[] — 平台类型数组。取值为各平台的枚举标识，先调用[「平台列表」](/api-reference/get-api-v2-channels-platforms)接口（`GET /api/v2/channels/platforms`），使用其返回的 `data[n].platform`。
- `status` number — 账号状态：`1` 正常（可用），`0` 异常（不可用）。

## Response `200`

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

- object
  - `data` ChannelAccountListVo
    - `total` number, required — 账号总数
    - `list` ChannelAccountVo[], required — 账号列表
      - `id` string, required — 账号 ID
      - `userId` string, required — 用户 ID
      - `type` 'douyin' | 'xhs' | 'wxSph' | 'KWAI' | 'youtube' | 'wxGzh' | 'bilibili' | 'twitter' | 'tiktok' | 'facebook' | 'instagram' | 'threads' | 'pinterest' | 'linkedin' | 'google_business', required — 平台
      - `clientType` 'web' | 'app' — 客户端类型
      - `uid` string, required — 平台账号 UID
      - `account` string — 平台账号名
      - `loginTime` string, date-time — 登录时间
      - `avatar` string — 头像 URL
      - `nickname` string, required — 昵称
      - `fansCount` number — 粉丝数
      - `followingCount` number — 关注数
      - `readCount` number — 阅读数
      - `likeCount` number — 点赞数
      - `collectCount` number — 收藏数
      - `forwardCount` number — 转发数
      - `commentCount` number — 评论数
      - `lastStatsTime` string, date-time — 最近统计时间
      - `workCount` number — 作品数
      - `income` number — 收入
      - `groupId` string, required — 账号分组 ID
      - `status` number, required — 账号状态
      - `rank` number — 排序值
      - `relayAccountRef` string, nullable — 转发账号引用
      - `createdAt` string, date-time — 创建时间
      - `updatedAt` string, date-time — 更新时间
  - `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)