> For the complete documentation index, see [llms.txt](https://docs.annict.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.annict.com/docs/ja/api/v1/characters.md).

# GET /v1/characters

Annictに登録されているキャラクター情報を取得することができます。

## フィールド

| 名前                          | 概要                                                               |
| --------------------------- | ---------------------------------------------------------------- |
| id                          | ID                                                               |
| name                        | 名前                                                               |
| name\_kana                  | 名前 (かな表記)                                                        |
| name\_en                    | 名前 (英語表記)                                                        |
| nickname                    | ニックネーム                                                           |
| nickname\_en                | ニックネーム (英語表記)                                                    |
| birthday                    | 誕生日                                                              |
| birthday\_en                | 誕生日 (英語表記)                                                       |
| age                         | 年齢                                                               |
| age\_en                     | 年齢 (英語表記)                                                        |
| blood\_type                 | 血液型                                                              |
| blood\_type\_en             | 血液型 (英語表記)                                                       |
| height                      | 身長                                                               |
| height\_en                  | 身長 (英語表記)                                                        |
| weight                      | 体重                                                               |
| weight\_en                  | 体重 (英語表記)                                                        |
| nationality                 | 国籍                                                               |
| nationality\_en             | 国籍 (英語表記)                                                        |
| occupation                  | 肩書き                                                              |
| occupation\_en              | 肩書き (英語表記)                                                       |
| description                 | キャラ紹介                                                            |
| description\_en             | キャラ紹介 (英語表記)                                                     |
| description\_source         | キャラ紹介の引用元                                                        |
| description\_source\_en     | キャラ紹介の引用元 (英語表記)                                                 |
| favorite\_characters\_count | お気に入りに入れている人の数                                                   |
| series                      | 紐づくシリーズ情報。取得できるフィールドは [Series](/docs/ja/api/v1/series.md) と同じです。 |

## パラメータ

| 名前           | 概要                                                | 使用例               |
| ------------ | ------------------------------------------------- | ----------------- |
| fields       | レスポンスボディに含まれるデータのフィールドを絞り込みます。                    | fields=id,name    |
| filter\_ids  | キャラクターをIDで絞り込みます。                                 | filter\_ids=1,2,3 |
| filter\_name | キャラクターを名前で絞り込みます。                                 | filter\_name=株式会社 |
| page         | ページ数を指定します。                                       | page=2            |
| per\_page    | 1ページに何件取得するかを指定します。デフォルトは `25` 件で、`50` 件まで指定できます。 | per\_page=30      |
| sort\_id     | キャラクターをIDで並び替えます。`asc` または `desc` が指定できます。        | sort\_id=desc     |

## リクエスト例

```
$ curl -X GET https://api.annict.com/v1/characters?access_token=(access_token)&filter_ids=7510
```

```javascript
{
  "characters": [
    {
      "id": 7510,
      "name": "岡部倫太郎",
      "name_kana": "おかべりんたろう",
      "name_en": "Okabe, Rintarou",
      "kind": "STEINS;GATE",
      "nickname": "鳳凰院凶真、おかりん",
      "nickname_en": "Hououin, Kyouma",
      "birthday": "12月14日",
      "birthday_en": "December 14",
      "age": "18歳",
      "age_en": "18",
      "blood_type": "A型",
      "blood_type_en": "A",
      "height": "177 cm",
      "height_en": "177 cm",
      "weight": "59 kg",
      "weight_en": "59 kg",
      "nationality": "日本",
      "nationality_en": "Japan",
      "occupation": "狂気のマッドサイエンティスト",
      "occupation_en": "Crazy Mad Scientist",
      "description": "未来ガジェット研究所のラボメンNo.001にして、ラボの創設者。東京電機大学1年生。まゆりや橋田からは「オカリン」と呼ばれている。実家は青果店。",
      "description_en": "",
      "description_source": " Wikipedia【STEINS;GATEの登場人物】",
      "description_source_en": "",
      "favorite_characters_count": 13,
      "series": {
        "id": 50,
        "name": "Steins;Gate",
        "name_ro": "",
        "name_en": ""
      }
    }
  ],
  "total_count": 1,
  "next_page": null,
  "prev_page": null
}
```