なろう小説API入門講座

小説投稿サイトである『小説家になろう』のデータを取得するには利用規約により小説家になろう公式が提供しているAPI『なろう小説API』を利用する必要があります。本同人誌はそんな『なろう小説API』の入門講座になります。

本同人誌では、なろう小説APIとなろうR18小説APIのパラメータの解説、プログラミングで必要になる基礎知識の確認、公式のサンプルコードの解説、筆者が作成したソースコードの解説を行います。これにより、紹介するソースコードをコピペし、少しの改変を行うことだけで欲しいデータを入手できるようになります。

筆者が作成したソースコードは4つあります。
・基本:「条件を指定して検索結果を3件表示する」では、機能を絞り短いソースコードでAPIをPythonでどうのように扱えばいいのかを確認します。
・発展:「指定した期間内の総合評価の分布を調べる(なろう版)」では、指定した期間(1年間)の間に投稿されたすべての短編作品の総合評価ポイントを取得し、その分布をヒストグラムなどで表示します。
・発展:「指定した期間内の総合評価の分布を調べる(ノクターン版)」では、なろうR18小説APIを使いノクターンノベルズのデータを取得する場合はどう読み替えていけばいいのかを確認します。
・その他:「なろうユーザ検索API」では、なろうユーザ検索APIを使用し、小説家になろうに登録しているユーザーの作品投稿数の分布を調査しました。

なお、これらの出力結果は体験版で読めます。
その他のなろうユーザ検索APIの出力結果について述べると、1割のユーザーが作品を投稿していること、そして、投稿者の中で投稿作品が1つのユーザーが6割を占めることが確認できました。

注意点として、小説家になろう公式はPHPを使ってAPIを動かしていますが、本同人誌ではGoogle ColaboratoryとPythonを使用しています。

体験版はページ番号1~42+αを公開しています。割合としては70%になります。ご確認ください。

まえがき… 1
第1章:なろうデベロッパーについて… 3
1-1:各APIの説明… 4

第2章:なろう小説APIついて… 5
2-1:出力見本… 5
2-2:出力… 7
2-3:ofパラメータ… 11
2-4:条件抽出GETパラメータ… 12
2-5:出力GETパラメータ… 17

第3章:なろうR18小説APIについて… 19
3-1:出力見本… 19
3-2:出力… 20
3-3:ofパラメータ… 20
3-4:条件抽出GETパラメータ… 20
3-5:出力GETパラメータ… 21

第4章:基礎知識… 22
4-1:プログラミング全般の知識… 22
4-2:PHPのルール… 28
4-3:Pythonのルール… 28
4-4:出力とJSON形式について… 29
4-5:Google Colaboratoryについて… 30

第5章:公式のサンプルコード解説… 31
5-1:なろう小説APIサンプルプログラム「作品簡易一覧(PHP)」… 31
5-2:なろう小説APIサンプルプログラム「ページ分割対応作品簡易一覧(PHP)」… 35

第6章:Pythonで作成したソースコード群… 42
6-1:基本:「条件を指定して検索結果を3件表示する」… 42
6-2:発展:「指定した期間内の総合評価の分布を調べる(なろう版)」… 46
6-2-1:統計の知識… 58
6-3:発展:「指定した期間内の総合評価の分布を調べる(ノクターン版)」… 59
6-4:その他:「なろうユーザ検索API」… 60
6-5:これから… 61

第7章:あとがき… 62
7-1:あとがき… 62
7-2:参考にしたサイト… 62

第8章:その他… 63
8-1:作成・編集メモ… 63
8-2:装丁情報… 63
8-3:既刊一覧… 64
8-4:奥付… 64