ニコニコのユーザー検索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を綺麗に見れる