Syosetu API
概要
Syosetu APIは、「小説家になろう」の公式Developer APIをラップした高機能APIサービスです。 キャッシュやレート制限を備え、作品情報とランキングを組み合わせて取得できるエンドポイントなど、公式APIより扱いやすい形でデータを提供します。
主な機能
- 作品情報取得: ncodeやキーワードから作品の詳細情報を取得(
/v1/novels)。ランキング履歴(/v1/novels/:ncode/ranking-history)も取得可能。 - ランキング取得: 日間・週間・月間などのランキングデータを取得(
/v1/rankings/:type)。 - 結合エンドポイント: ランキングと作品情報(タイトル・あらすじ・ジャンル等)を1回の呼び出しで結合取得できる
/hydratedエンドポイント。 - ユーザ(作者)検索: 作者名やuseridから作者情報を検索・取得(
/v1/users)。 - R18作品対応: R18作品の検索・詳細取得も別エンドポイント(
/v1/r18/novels)で提供。 - キャッシュ・レート制限: 上流APIへの負荷を抑えつつ高速にレスポンス。
- ジャンルラベル付与: 通常ジャンル・R18ジャンルのコードを人間が読みやすいラベルに変換するメタ情報エンドポイントを提供。