---
title: "获取小组列表"
method: GET
path: "/p1/groups"
tags: ["group"]
---

# 获取小组列表

`GET /p1/groups`

## Query parameters

- `mode` 'all' | 'joined' | 'managed' — 小组过滤模式 - all = 所有小组 - joined = 我加入的小组 - managed = 我管理的小组
- `sort` 'posts' | 'topics' | 'members' | 'created' | 'updated', required — 小组排序方式 - posts = 帖子数 - topics = 主题数 - members = 成员数 - created = 创建时间 - updated = 最新讨论
- `limit` integer
- `offset` integer

## Response `200`

Default Response

- object
  - `data` SlimGroup[], required
    - `accessible` boolean, required
    - `createdAt` integer, required
    - `creatorID` integer, required
    - `icon` Avatar, required
      - `large` string, required
      - `medium` string, required
      - `small` string, required
    - `id` integer, required
    - `members` integer, required
    - `name` string, required
    - `nsfw` boolean, required
    - `title` string, required
  - `total` integer, required — limit+offset 为参数的请求表示总条数，page 为参数的请求表示总页数

## Other responses

- `500` — 意料之外的服务器错误

---

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