なろう小説APIでは小説家になろうに掲載されている小説情報を取得できます。
注意：このAPIではR18小説は取得できません。R18取得APIはコチラ

なろうAPIはHTTPでのリクエストに対してJSON形式、JSONP形式又はYAML形式、PHPのserializeで応答します。 実際に小説のデータが修正されてからなろうAPIに反映されるまで平均5分程度(最大2時間)の誤差があります。

APIを使うためにはJavaScriptあるいはPerl/PHP/Ruby/Java/C言語などでプログラミングが必要です。

出力要素の追加について(2019/8/20) 小説情報の出力要素に感想数、期間別ポイントを表す項目を追加しました。詳細は出力をご覧ください。 また、項目の追加に伴い出力GETパラメータのofで利用可能な値を追加しました。詳細は出力のofパラメータをご覧ください。 出力要素の追加について(2016/5/24) 小説情報の出力要素に登録必須キーワードの有無を表す項目を追加しました。詳細は出力をご覧ください。 また、項目の追加に伴い出力GETパラメータのofで利用可能な値を追加しました。詳細は出力のofパラメータをご覧ください。 利用可能なGETパラメータの追加について(2016/5/24) 条件抽出GETパラメータで、登録必須キーワードに「異世界転生」「異世界転移」が含まれる小説のみを抽出できるようになりました。 同様に、条件除外GETパラメータで登録必須キーワードに「異世界転生」「異世界転移」が含まれる小説を除外できるようになりました。 Atom形式の出力に関する動作について(2015/04/07) Atomフィードの日付にあたる項目に、最終掲載日(general_lastup)ではなく小説の更新日時(novelupdated_at)が出力されている点を修正しました。 最終掲載日の取得を正しく行なう場合はパラメータの追加をお願いします。

---

JSON形式、JSONP形式またはYAML形式、PHPのserialize
標準はYAML形式となっていますが、outパラメータで変更できます。
文字コードはUTF-8です。

---

https://api.syosetu.com/novelapi/api/

GETで送信。POSTでは受信できません。
日本語などマルチバイト文字送信時は文字コードをUTF-8にし、URLエンコードしてください。

---

パラメータ	値	説明
gzip	int(1～5)	gzip圧縮してgzipファイルとして返します。 gzip圧縮レベルを1～5で指定できます。 転送量上限を減らすためにも推奨
out	string	出力形式をyamlまたはjsonまたはphpを指定。 未指定時はYAMLになる。outパラメータの詳細
of	string	出力する項目を個別に指定できます。未指定時は全項目出力されます。 転送量軽減のため、このパラメータの使用が推奨されます。 複数項目を出力する場合は-で区切ってください。詳しくは出力の項目をご覧ください。
lim	int(1～500)	最大出力数を指定できます。最低1、最高500です。 半角数字で指定してください。 指定しない場合は20件になります。
st	int(1～2000)	表示開始位置の指定です。半角数字で指定してください。 たとえば全部で10作品あるとして、3作品目以降の小説情報を取得したい場合は3と指定してください。
order	string	出力順序を指定できます。 指定しない場合は新着更新順となります。 new 新着更新順 favnovelcnt ブックマーク数の多い順 reviewcnt レビュー数の多い順 hyoka 総合ポイントの高い順 hyokaasc 総合ポイントの低い順 dailypoint 日間ポイントの高い順 weeklypoint 週間ポイントの高い順 monthlypoint 月間ポイントの高い順 quarterpoint 四半期ポイントの高い順 yearlypoint 年間ポイントの高い順 impressioncnt 感想の多い順 hyokacnt 評価者数の多い順 hyokacntasc 評価者数の少ない順 weekly 週間ユニークユーザの多い順 毎週火曜日早朝リセット (前週の日曜日から土曜日分) lengthdesc 小説本文の文字数が多い順 lengthasc 小説本文の文字数が少ない順 ncodedesc 新着投稿順 old 更新が古い順

---

出力形式を指定できます。
jsonまたはyamlまたはphpで指定してください。

yaml:

YAML形式(デフォルト)

json:

JSON形式

php:

PHPのserialize()

atom:

Atomフィード

jsonp:

JSONP形式

---

　　　　▽検索単語指定

パラメータ	値	説明
word	string	単語を指定できます。文字コードはUTF-8でURLエンコードしてください。 半角または全角スペースで区切るとAND抽出になります。部分一致でHITします。
notword	string	含みたくない単語を指定できます。文字コードはUTF-8でURLエンコードしてください。 スペースで区切ることにより含ませない単語を増やせます。部分一致で除外されます。

　　　　▽抽出対象の範囲

パラメータ	値	説明
title	int	1の場合はタイトルをwordとnotwordの抽出対象にします。
ex	int	1の場合はあらすじをwordとnotwordの抽出対象にします。
keyword	int	1の場合はキーワードをwordとnotwordの抽出対象にします。
wname	int	1の場合は作者名をwordとnotwordの抽出対象にします。

　　　　※上記4項目すべて指定しない場合は全項目抽出対象と扱います。
　　　　※wordがNコードと判断される文字列の場合、抽出対象はすべて無視され、Nコードから
　　　　小説を探します。

　　　　▽大ジャンル指定

パラメータ	値	説明
biggenre	int string	大ジャンルを指定できます。ハイフン(-)記号で区切れば複数大ジャンルを一括抽出できます。 1: 恋愛 2: ファンタジー 3: 文芸 4: SF 99: その他 98: ノンジャンル

　　　　▽大ジャンル除外指定

パラメータ	値	説明
notbiggenre	int string	大ジャンルを除外検索できます。ハイフン(-)記号で区切れば含ませたくない大ジャンルを増やせます。 1: 恋愛 2: ファンタジー 3: 文芸 4: SF 99: その他 98: ノンジャンル

　　　　▽ジャンル指定

パラメータ	値	説明
genre	int string	ジャンルを指定できます。ハイフン(-)記号で区切れば複数ジャンルを一括抽出できます。 101: 異世界〔恋愛〕 102: 現実世界〔恋愛〕 201: ハイファンタジー〔ファンタジー〕 202: ローファンタジー〔ファンタジー〕 301: 純文学〔文芸〕 302: ヒューマンドラマ〔文芸〕 303: 歴史〔文芸〕 304: 推理〔文芸〕 305: ホラー〔文芸〕 306: アクション〔文芸〕 307: コメディー〔文芸〕 401: VRゲーム〔SF〕 402: 宇宙〔SF〕 403: 空想科学〔SF〕 404: パニック〔SF〕 9901: 童話〔その他〕 9902: 詩〔その他〕 9903: エッセイ〔その他〕 9904: リプレイ〔その他〕 9999: その他〔その他〕 9801: ノンジャンル〔ノンジャンル〕

　　　　▽ジャンル除外指定

パラメータ	値	説明
notgenre	int string	ジャンルを除外検索できます。ハイフン(-)記号で区切れば含ませたくないジャンルを増やせます。 101: 異世界〔恋愛〕 102: 現実世界〔恋愛〕 201: ハイファンタジー〔ファンタジー〕 202: ローファンタジー〔ファンタジー〕 301: 純文学〔文芸〕 302: ヒューマンドラマ〔文芸〕 303: 歴史〔文芸〕 304: 推理〔文芸〕 305: ホラー〔文芸〕 306: アクション〔文芸〕 307: コメディー〔文芸〕 401: VRゲーム〔SF〕 402: 宇宙〔SF〕 403: 空想科学〔SF〕 404: パニック〔SF〕 9901: 童話〔その他〕 9902: 詩〔その他〕 9903: エッセイ〔その他〕 9904: リプレイ〔その他〕 9999: その他〔その他〕 9801: ノンジャンル〔ノンジャンル〕

　　　　▽ユーザID指定

パラメータ	値	説明
userid	int string	ユーザIDで抽出可能。ハイフン(-)記号で区切ればユーザIDのOR検索ができます。

　　　　▽登録必須キーワード指定 　　　　

パラメータ	値	説明
isr15	int	1を指定した場合、登録必須キーワードに「R15」が含まれている小説のみを抽出します。
isbl	int	1を指定した場合、登録必須キーワードに「ボーイズラブ」が含まれている小説のみを抽出します。
isgl	int	1を指定した場合、登録必須キーワードに「ガールズラブ」が含まれている小説のみを抽出します。
iszankoku	int	1を指定した場合、登録必須キーワードに「残酷な描写あり」が含まれている小説のみを抽出します。
istensei	int	1を指定した場合、登録必須キーワードに「異世界転生」が含まれている小説のみを抽出します。
istenni	int	1を指定した場合、登録必須キーワードに「異世界転移」が含まれている小説のみを抽出します。
istt	int	1を指定した場合、登録必須キーワードに「異世界転生」または「異世界転移」が含まれている小説のみを抽出します。

　　　　▽登録必須キーワード除外指定 　　　　

notr15	int	1を指定した場合、登録必須キーワードに「R15」が含まれている小説を除外し抽出します。
notbl	int	1を指定した場合、登録必須キーワードに「ボーイズラブ」が含まれている小説を除外し抽出します。
notgl	int	1を指定した場合、登録必須キーワードに「ガールズラブ」が含まれている小説を除外し抽出します。
notzankoku	int	1を指定した場合、登録必須キーワードに「残酷な描写あり」が含まれている小説を除外し抽出します。
nottensei	int	1を指定した場合、登録必須キーワードに「異世界転生」が含まれている小説を除外し抽出します。
nottenni	int	1を指定した場合、登録必須キーワードに「異世界転移」が含まれている小説を除外し抽出します。

　　　　▽文字数指定

パラメータ	値	説明
minlen	int	抽出する小説の最小文字数を指定できます。 文字数とは小説から一部タグ記号(改ページ等)、ルビ、ルビのふりがな部分、みてみんの画像挿入コード、スペース、改行を抜いた値です。
maxlen	int	抽出する小説の最大文字数。文字数とは小説から一部タグ記号(改ページ等)、ルビ、ルビのふりがな部分、みてみんの画像挿入コード、スペース、改行を抜いた値です。
length	int string	抽出する小説の文字数を指定できます。minlenまたはmaxlenと併用はできません。 文字数とは小説から一部タグ記号(改ページ等)、ルビ、ルビのふりがな部分、みてみんの画像挿入コード、スペース、改行を抜いた値です。 範囲指定する場合は、最小文字数と最大文字数をハイフン(-)記号で区切ってください。

　　　　▽会話率指定

パラメータ	値	説明
kaiwaritu	int string	抽出する小説の会話率を%単位で指定できます。 範囲指定する場合は、最低数と最大数をハイフン(-)記号で区切ってください。

　　　　▽挿絵数指定

パラメータ	値	説明
sasie	int string	抽出する小説の挿絵の数を指定できます。 範囲指定する場合は、最小数と最大数を-(ハイフン)記号で区切ってください。

　　　　▽読了時間指定
　　　　※読了時間は文字数(minlen、maxlen、length)と併用不可

パラメータ	値	説明
mintime	int	抽出する小説の最低読了時間を分単位で指定できます。 読了時間は小説文字数÷500を切り上げした数字です。
maxtime	int	抽出する小説の最大読了時間を分単位で指定できます。 読了時間は小説文字数÷500を切り上げした数字です。
time	int string	抽出する小説の読了時間を指定できます。mintimeまたはmaxtimeと併用はできません。 読了時間は小説文字数÷500を切り上げした数字です。 範囲指定する場合は、最小文字数と最大文字数をハイフン(-)記号で区切ってください。

　　　　▽Nコード指定

パラメータ	値	説明
ncode	string	Nコードで抽出可能。ハイフン(-)記号で区切ればNコードのOR検索ができます。 開示設定が「検索除外中です」となっている作品は抽出できません。

　　　　▽小説タイプ指定

パラメータ	値	説明
type	string	小説タイプを指定できます。 　t：短編 　r：連載中 　er：完結済連載小説 　re：すべての連載小説(連載中および完結済) 　ter：短編と完結済連載小説

　　　　▽文体指定

パラメータ	値	説明
buntai	int string	文体を指定できます。ハイフン(-)記号で区切ればOR検索できます。 　1：字下げされておらず、連続改行が多い作品 　2：字下げされていないが、改行数は平均な作品 　4：字下げが適切だが、連続改行が多い作品 　6：字下げが適切でかつ改行数も平均な作品

　　　　▽連載停止中指定

パラメータ	値	説明
stop	int	連載停止中作品に関する指定ができます。 　1：長期連載停止中を除きます 　2：長期連載停止中のみ取得します

　　　　▽最終掲載日指定

パラメータ	値	説明
lastup	string	最終掲載日(general_lastup)で抽出できます。以下の文字列を指定できます。 　thisweek：今週(日曜日の午前0時はじまり) 　lastweek：先週 　sevenday：過去7日間(7日前の午前0時はじまり) 　thismonth：今月 　lastmonth：先月 タイムスタンプで指定 　開始日と終了日をハイフン(-)記号で区切ることでUNIXタイムスタンプで抽出できます。 　UNIXタイムスタンプとは1970年1月1日からの通算秒数のことです。

　　　　▽ピックアップ指定

パラメータ	値	説明
ispickup	int	1を指定した場合、小説ピックアップの対象となっている小説のみを抽出します。

---

APIサーバが出力する文字コードはUTF-8です。デフォルトはYAML形式です。
outパラメータでJSON形式などにも変更できます。(注:atomフィードのみ出力制限あり)
最初の要素には全小説出力数が入り、以降、一作品ずつ情報が入っています。

要素	説明
allcount	全小説出力数です。 (注：1000作品以上の場合、最長で4時間遅れの情報となる場合があります)
title	小説名
ncode	Nコード
userid	作者のユーザID(数値)
writer	作者名
story	小説のあらすじ
biggenre	大ジャンル 1: 恋愛 2: ファンタジー 3: 文芸 4: SF 99: その他 98: ノンジャンル
genre	ジャンル 101: 異世界〔恋愛〕 102: 現実世界〔恋愛〕 201: ハイファンタジー〔ファンタジー〕 202: ローファンタジー〔ファンタジー〕 301: 純文学〔文芸〕 302: ヒューマンドラマ〔文芸〕 303: 歴史〔文芸〕 304: 推理〔文芸〕 305: ホラー〔文芸〕 306: アクション〔文芸〕 307: コメディー〔文芸〕 401: VRゲーム〔SF〕 402: 宇宙〔SF〕 403: 空想科学〔SF〕 404: パニック〔SF〕 9901: 童話〔その他〕 9902: 詩〔その他〕 9903: エッセイ〔その他〕 9904: リプレイ〔その他〕 9999: その他〔その他〕 9801: ノンジャンル〔ノンジャンル〕
gensaku	現在未使用項目(常に空文字列が返ります)
keyword	キーワード
general_firstup	初回掲載日 YYYY-MM-DD HH:MM:SSの形式
general_lastup	最終掲載日 YYYY-MM-DD HH:MM:SSの形式
novel_type	連載の場合は1、短編の場合は2
end	短編小説と完結済小説は0となっています。連載中は1です。
general_all_no	全掲載部分数です。短編の場合は1です。
length	小説文字数です。スペースや改行は文字数としてカウントしません。
time	読了時間(分単位)です。読了時間は小説文字数÷500を切り上げした数値です。
isstop	長期連載停止中なら1、それ以外は0です。
isr15	登録必須キーワードに「R15」が含まれる場合は1、それ以外は0です。
isbl	登録必須キーワードに「ボーイズラブ」が含まれる場合は1、それ以外は0です。
isgl	登録必須キーワードに「ガールズラブ」が含まれる場合は1、それ以外は0です。
iszankoku	登録必須キーワードに「残酷な描写あり」が含まれる場合は1、それ以外は0です。
istensei	登録必須キーワードに「異世界転生」が含まれる場合は1、それ以外は0です。
istenni	登録必須キーワードに「異世界転移」が含まれる場合は1、それ以外は0です。
pc_or_k	1はケータイのみ、2はPCのみ、3はPCとケータイで投稿された作品です。 対象は投稿と次話投稿時のみで、どの端末で執筆されたかを表すものではありません。
global_point	総合評価ポイント(=(ブックマーク数×2)+評価ポイント)
daily_point	日間ポイント (ランキング集計時点から過去24時間以内で新たに登録されたブックマークや評価が対象)
weekly_point	週間ポイント (ランキング集計時点から過去7日以内で新たに登録されたブックマークや評価が対象)
monthly_point	月間ポイント (ランキング集計時点から過去30日以内で新たに登録されたブックマークや評価が対象)
quarter_point	四半期ポイント (ランキング集計時点から過去90日以内で新たに登録されたブックマークや評価が対象)
yearly_point	年間ポイント (ランキング集計時点から過去365日以内で新たに登録されたブックマークや評価が対象)
fav_novel_cnt	ブックマーク数
impression_cnt	感想数
review_cnt	レビュー数
all_point	評価ポイント
all_hyoka_cnt	評価者数
sasie_cnt	挿絵の数
kaiwaritu	会話率
novelupdated_at	小説の更新日時
updated_at	最終更新日時 (注意：システム用で小説更新時とは関係ありません)

▼ofパラメータ
出力する項目を個別に指定できます。未指定時は全項目出力されます。転送量軽減のため、このパラメータの使用が推奨されます。 複数項目を出力する場合はハイフン(-)記号で区切ってください。

t:

title

n:

ncode

u:

userid

w:

writer

s:

story

bg:

biggenre

g:

genre

k:

keyword

gf:

general_firstup

gl:

general_lastup

nt:

noveltype
※novel_typeではございません

e:

end

ga:

general_all_no

l:

length

ti:

time

i:

isstop

ir:

isr15

ibl:

isbl

igl:

isgl

izk:

iszankoku

its:

istensei

iti:

istenni

p:

pc_or_k

gp:

global_point

dp:

daily_point

wp:

weekly_point

mp:

monthly_point

qp:

quarter_point

yp:

yearly_point

f:

fav_novel_cnt

imp:

impression_cnt

r:

review_cnt

a:

all_point

ah:

all_hyoka_cnt

sa:

sasie_cnt

ka:

kaiwaritu

nu:

novelupdated_at

ua:

updated_at

▼オプション項目
optパラメータに以下の文字列を指定するとオプション項目を取得できます。

・weekly
　　週間ユニークユーザ[項目名:weekly_unique]が追加されます。
　　週間ユニークユーザは前週の日曜日から土曜日分のユニークの合計です。
　　毎週火曜日早朝に更新されます。

---

なろう小説APIにはさまざまな時刻項目があります。

項目	説明
general_firstup	初回掲載日です。最初に小説を掲載した日時となっております。原則として初回掲載日が変わることはありません。
general_lastup	小説最終掲載日です。小説を公開した時点で反映されます。 上のgeneral_firstupと違い連載小説の場合、次話投稿時にも反映されます。ただし編集の場合は反映されません。
novelupdated_at	小説の更新時刻 最後に小説データが更新された時刻です。
updated_at	データ更新時刻 最後にデータが更新された時刻です。なろう小説APIの場合、総合評価ポイントが変わった場合なども反映されます。 小説の更新時刻ではありません。

---

利用制限は現在、休止しています。
負荷状況により今後、導入されることがあるためキャッシュの導入など、利用制限を想定したシステム設計をお願いします。ただし、古い情報を誤って掲載しないよう一定期間(長くても２週間)でキャッシュの更新・削除をお願いします。

IPアドレスごとに利用制限を行います。
1日の利用上限は80,000または転送量上限400MByteです。
利用制限は初回アクセスから24時間が適用範囲です。
初回のアクセスから24時間後に回数と転送量を記録していたカウンタと
初回アクセス時刻をリセットします。
なお、1日の利用上限を超えた場合、エラーの発生確率が増します。
混雑状況にもよりますが、リクエスト回数または転送量が利用上限の
120%を超えるとほとんど接続できなくなります。

備考：利用制限カウンタは厳密ではなく多少のマージンを設けてあります。
転送量は圧縮することで減らせます。

転送量制限の回避方法

• gzip=5を指定し、gzipファイルで受信する。
  デメリットとして受け取り側で解凍する手間は発生するが、かなりの転送量を削減できる。
• YAML形式を使う。一番容量が小さいため。
• ofパラメータを使い、必要な項目のみを出力する。

---

データベースサーバは日本国内の複数拠点に分散されていることがあります。
APIから小説データベースに接続した場合、原則としてスレーブサーバにつながります。
マスタサーバとスレーブサーバ間は10秒以内にデータを同期しています。

しかし、何らかのネットワーク障害が発生した場合、遅延が発生、サーバによって
データにばらつきが生じることがあります。
また、実際に小説のデータが修正されてからなろうAPIに反映されるまで
平均5分程度(最大2時間)の誤差があります。

stopパラメータ、global_point、fav_novel_cnt、review_cnt、all_point、all_hyoka_cnt項目に関してはキャッシュの都合上、さらに15分から2時間の遅れがあります。
allcount出力については作品数計算による負荷削減防止のため、1000作品以上の出力に限り最長で4時間前の結果が表示されることがあります。

---

サンプルプログラムを用意しております。
・小説簡易一覧(PHP)
・ページ分割対応小説簡易一覧(PHP)

---

条件抽出GETパラメータは「小説を読もう！」でも利用することができます。
たとえば、https://yomou.syosetu.com/search.php?genre=101とすれば
ジャンルがファンタジー〔恋愛〕の作品だけの検索結果が得られます。
(一部で処理方法を変えており、完全な互換性を維持しているわけではありません)