ニコニコのユーザー検索API

きっかけ

配信者や動画投稿者を検索できる「ユーザー検索」を追加しました【Android版nicocasアプリ】
https://blog.nicovideo.jp/niconews/105098.html

リクエスト

ログインセッションは不要で

https://api.cas.nicovideo.jp/v1/search/users?searchWord={検索キーワード}

にGETリクエストを送ることでjsonテキストが返ってくる。

レスポンスの例

https://api.cas.nicovideo.jp/v1/search/users?searchWord=Sin

とリクエストした場合のレスポンス例（2019/05/04時点）

{
    "meta": {
        "status": 200,
        "totalCount": 960,
        "ssId": "64269989-b416-4929-914e-a3980dfe8f21"
    },
    "data": {
        "users": [{
            "id": "8174142",
            "nickname": "Sin",
            "icons": {
                "urls": {
                    "150x150": "https://secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/817/8174142.jpg?1489936219",
                    "50x50": "https://secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/s/817/8174142.jpg?1489936219"
                }
            },
            "description": "主に東方×FFのクロスオーバー二次創作や<br>\nテイルズオブシリーズの秘奥義集や<br>\n少年ジャンプ関連ゲームのトーナメント企画を投稿しています<br><br>\n動画の進捗報告等しているツイッター<br>\n@Sin_ncd",
            "followerCount": 5646,
            "videoCount": 438,
            "liveCount": 0
        }, {
            "id": "21219275",
            "nickname": "sin",
            "icons": {
                "urls": {
                    "150x150": "https://secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/2121/21219275.jpg?1453635625",
                    "50x50": "https://secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/s/2121/21219275.jpg?1453635625"
                }
            },
            "description": "",
            "followerCount": 520,
            "videoCount": 36,
            "liveCount": 0
        }, {
            "id": "4697825",
            "nickname": "SIN",
            "icons": {
                "urls": {
                    "150x150": "https://secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/469/4697825.jpg?1380033478",
                    "50x50": "https://secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/s/469/4697825.jpg?1380033478"
                }
            },
            "description": "MHF3鯖で活動しているSINです<br>\n<br>\n主にMHFの動画を上げていますがたまに他の動画を上げることも…<br>\n<br>\nMHF動画一覧→mylist/20382131\n",
            "followerCount": 678,
            "videoCount": 85,
            "liveCount": 1261
        }, {
            "id": "27385303",
            "nickname": "Sin_2",
            "icons": {
                "urls": {
                    "150x150": "https://secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/2738/27385303.jpg?1336016823",
                    "50x50": "https://secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/s/2738/27385303.jpg?1336016823"
                }
            },
            "description": "メインのアカウントはこちらです→user/8174142<br><br>\n何かあった場合の連絡はこちらまで<br>\nhttps://twitter.com/Sin_ncd",
            "followerCount": 1847,
            "videoCount": 65,
            "liveCount": 0
        }, {
            "id": "13155337",
            "nickname": "Sin",
            "icons": {
                "urls": {
                    "150x150": "https://secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/1315/13155337.jpg?1527254787",
                    "50x50": "https://secure-dcdn.cdn.nimg.jp/nicoaccount/usericon/s/1315/13155337.jpg?1527254787"
                }
            },
            "description": "Sinと申します。",
            "followerCount": 76,
            "videoCount": 270,
            "liveCount": 3
        }]
    }
}

URLパラメータの説明

searchWord

文字列、必須
検索キーワード、URLパラメータエスケープが必要

offset

0以上の整数、オプション
受け取りたい検索結果の先頭位置を指定
デフォルトは0

limit

0以上の整数、オプション
受け取りたい検索結果の最大数を指定
デフォルトは5

sort

文字列？、オプション
followerCount videoCount liveCount は指定可能と確認。
デフォルトは不明

order

asc または desc を指定、オプション
デフォルトは desc （大きい値のものが先頭に来る）

参考

https://jsonlint.com/
Jsonを綺麗に見れる