---
title: "GET /clubs"
method: GET
path: "/clubs"
tags: ["clubs"]
---

# GET /clubs

`GET /clubs`

## Request

- Base URL: `https://api.jikan.moe/v4`
- URL: `https://api.jikan.moe/v4/clubs`
- Auth: none declared

## Query parameters

- `page` integer
- `limit` integer
- `q` string
- `type` 'public' | 'private' | 'secret': Club Search Query Type
- `category` 'anime' | 'manga' | 'actors_and_artists' | 'characters' | 'cities_and_neighborhoods' | 'companies' | 'conventions' | 'games' | 'japan' | 'music' | 'other' | 'schools': Club Search Query Category
- `order_by` 'mal_id' | 'name' | 'members_count' | 'created': Club Search Query OrderBy
- `sort` 'desc' | 'asc': Search query sort direction
- `letter` string

## Response `200`

Returns search results for clubs

- ClubsSearch: Clubs Search Resource
  - `data` Club[]
    - `mal_id` integer: MyAnimeList ID
    - `name` string: Club name
    - `url` string: Club URL
    - `images` CommonImages
      - `jpg` object: Available images in JPG
        - `image_url` string, nullable: Image URL JPG
    - `members` integer: Number of club members
    - `category` 'actors & artists' | 'anime' | 'characters' | 'cities & neighborhoods' | 'companies' | 'conventions' | 'games' | 'japan' | 'manga' | 'music' | 'others' | 'schools': Club Category
    - `created` string: Date Created ISO8601
    - `access` 'public' | 'private' | 'secret': Club access
  - `pagination` object
    - `last_visible_page` integer
    - `has_next_page` boolean

## Other responses

- `400`: Error: Bad request. When required parameters were not supplied.

## Changes

- **2023-06-02** `e5c562e7ba46`: 2 breaking, 1 info
  - removed the enum value `pictures_count` from the `query` request parameter `order_by`
  - removed the enum value `title` from the `query` request parameter `order_by`
  - added the new enum value `name` to the `query` request parameter `order_by`
- **2022-06-07** `660c331cabd5`: 1 warning, 8 info
  - removed the optional property `allOf[subschema #1]/data/items/data` from the response with the `200` status
  - added the optional property `allOf[subschema #1]/data/items/access` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/data/items/category` to the response with the `200` status
  - added the optional property `allOf[subschema #1]/data/items/created` to the response with the `200` status
  - …5 more

[Operation history](https://skmtc.dev/jikan/apis/jikan-api/changes/clubs/get.md)

---

[API](https://skmtc.dev/jikan/apis/jikan-api.md) - [All operations](https://skmtc.dev/jikan/apis/jikan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jikan/apis/jikan-api/revisions/ae6dd9d554d6?raw)