TOP / 技術マニュアル / 利用実績 / 商標ガイドライン

なろう小説API

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

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

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

小説情報の出力要素に登録必須キーワードの有無を表す項目を追加しました。詳細は出力をご覧ください。
また、項目の追加に伴い出力GETパラメータのofで利用可能な値を追加しました。詳細は出力のofパラメータをご覧ください。


条件抽出GETパラメータで、登録必須キーワードに「異世界転生」「異世界転移」が含まれる小説のみを抽出できるようになりました。
同様に、条件除外GETパラメータで登録必須キーワードに「異世界転生」「異世界転移」が含まれる小説を除外できるようになりました。


Atomフィードの日付にあたる項目に、最終掲載日(general_lastup)ではなく小説の更新日時(novelupdated_at)が出力されている点を修正しました。
最終掲載日の取得を正しく行なう場合はパラメータの追加をお願いします。


・出力形式

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

・APIのURL

http://api.syosetu.com/novelapi/api/

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

・出力GETパラメータ


パラメータ 説明
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 出力順序を指定できます。
指定しない場合は新着順となります。

allunique 閲覧者の多い順(未実装)
favnovelcnt ブックマーク数の多い順
reviewcnt レビュー数の多い順
hyoka 総合評価の高い順
hyokaasc 総合評価の低い順
impressioncnt 感想の多い順
hyokacnt 評価者数の多い順
hyokacntasc 評価者数の少ない順
weekly 週間ユニークユーザの多い順
毎週火曜日早朝リセット
(前週の日曜日から土曜日分)
lengthdesc 小説本文の文字数が多い順
lengthasc 小説本文の文字数が少ない順
ncodedesc Nコードが新しい順
old 古い順


・outパラメータの詳細

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

yaml:
YAML形式(デフォルト)
json:
JSON形式
php:
PHPのserialize()

atom:
Atomフィード
jsonp:
JSONP形式

JSONPの使い方
JSONPを利用することでJavaScriptから直接、APIを利用できるようになります。

callback
コールバック関数名。コールバック関数名には半角英数時など/^\$?[a-zA-Z0-9\[\]\.\_]+$/ (perl) の正規表現に一致する関数名を指定してください。


http://api.syosetu.com/novelapi/api/?out=jsonp&callback=call
JSONP形式でコールバック関数名をcallにしたい場合のURLです。

YAML形式の出力に関する動作について
出力形式にYAMLを指定した場合、パラメータを指定する事で利用するライブラリを変更できます。
パラメータ 説明
libtype int 利用するライブラリを指定できます。
未指定もしくは1以下の値を指定した場合、従来通りのライブラリを利用します。
2以上の値を指定すると、新ライブラリを利用します。

新ライブラリでは以下の点が従来のライブラリと異なります。
・文字列と数値の型指定が厳格化します。
・マルチバイト文字や一部の制御文字がエスケープ処理されます。

例1
http://api.syosetu.com/novelapi/api/?libtype=1
従来通りのライブラリで出力を行ないます。
小説名や作者名等、文字列が格納される部分が数値で構成されている場合でも、数値はダブルクォートで囲まれません。

例2
http://api.syosetu.com/novelapi/api/?libtype=2
新ライブラリで出力を行ないます。
小説名や作者名等、文字列が格納される部分が数値で構成されている場合、数値がダブルクォートで囲まれます。

Atomフィード形式の出力に関する動作について
Atomフィードの日付にあたる項目に、最終掲載日(general_lastup)ではなく小説の更新日時(novelupdated_at)が出力されていることが判明しました為、最終掲載日の取得を正しく行なう為のパラメータを追加しました。
お手数をお掛けしますが、日付の出力に最終掲載日を必要とする場合は、追加のパラメータをご利用いただきますようお願いいたします。
パラメータ 説明
updatetype int 日付として出力する項目を指定できます。
2の値を指定すると、最終掲載日(general_lastup)を日付として出力します。
未指定の場合、従来通り小説の更新日時(novelupdated_at)を日付として出力します。

例1
http://api.syosetu.com/novelapi/api/?out=atom
従来通り、小説の更新日時(novelupdated_at)を日付として出力します。

例2
http://api.syosetu.com/novelapi/api/?out=atom&updatetype=2
最終掲載日(general_lastup)を日付として出力します。


・条件抽出GETパラメータ


    ▽検索単語指定
パラメータ 説明
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:
ノンジャンル


http://api.syosetu.com/novelapi/api/?biggenre=2
大ジャンルがファンタジーとなっている小説の小説情報を取得するURLです。

例2
http://api.syosetu.com/novelapi/api/?biggenre=1-3
大ジャンルが恋愛または文芸となっている小説の小説情報を取得するURLです。


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


http://api.syosetu.com/novelapi/api/?notbiggenre=4
大ジャンルがSFとなっている小説以外の小説情報を取得するURLです。

http://api.syosetu.com/novelapi/api/?notbiggenre=1-2
大ジャンルが恋愛あるいはファンタジーとなっている小説以外の小説情報を取得するURLです。


    ▽ジャンル指定
パラメータ 説明
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:
ノンジャンル〔ノンジャンル〕


http://api.syosetu.com/novelapi/api/?genre=102
ジャンルが現実世界〔恋愛〕となっている小説の小説情報を取得するURLです。

例2
http://api.syosetu.com/novelapi/api/?genre=201-303
ジャンルがハイファンタジー〔ファンタジー〕または歴史〔文芸〕となっている小説の小説情報を取得するURLです。


    ▽ジャンル除外指定
パラメータ 説明
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:
ノンジャンル〔ノンジャンル〕


http://api.syosetu.com/novelapi/api/?notgenre=302
ジャンルがヒューマンドラマ〔文芸〕となっている小説以外の小説情報を取得するURLです。

http://api.syosetu.com/novelapi/api/?notgenre=303-401
ジャンルが歴史〔文芸〕あるいはVRゲーム〔SF〕となっている小説以外の小説情報を取得するURLです。


    ▽ユーザ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と併用はできません。
文字数とは小説からタグ、スペース、改行を抜いた値です。
範囲指定する場合は、最小文字数と最大文字数をハイフン(-)記号で区切ってください。


http://api.syosetu.com/novelapi/api/?length=10000
文字数が1万文字ちょうどの小説の小説情報を取得するURLです。

http://api.syosetu.com/novelapi/api/?length=2000-3000
文字数が2000文字から3000文字の小説の小説情報を取得するURLです。

http://api.syosetu.com/novelapi/api/?length=10000-
文字数が10000文字以上の小説の小説情報を取得するURLです。

http://api.syosetu.com/novelapi/api/?length=-15000
文字数が15000文字以下の小説の小説情報を取得するURLです。


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


http://api.syosetu.com/novelapi/api/?kaiwaritu=10-50
会話率が10%~50%までの作品を抽出します。

http://api.syosetu.com/novelapi/api/?kaiwaritu=0-50
会話率が0%~50%までの作品つまり50%以下の作品を抽出します。

http://api.syosetu.com/novelapi/api/?kaiwaritu=50-
会話率が50%以上の作品を抽出します。

http://api.syosetu.com/novelapi/api/?kaiwaritu=30
会話率が30%ちょうどの作品を抽出します。


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


http://api.syosetu.com/novelapi/api/?sasie=1-
挿絵が存在する、つまり1以上を取得します。

http://api.syosetu.com/novelapi/api/?sasie=1-5
挿絵が1つから5つまでの作品を指定します。

http://api.syosetu.com/novelapi/api/?sasie=30
挿絵が3つの作品を抽出します。


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


http://api.syosetu.com/novelapi/api/?time=10
読了時間が10分ちょうどの小説の小説情報を取得するURLです。

http://api.syosetu.com/novelapi/api/?time=30-100
読了時間が30分~100分の小説の小説情報を取得するURLです。

http://api.syosetu.com/novelapi/api/?time=10-
読了時間が10分以上の小説の小説情報を取得するURLです。

http://api.syosetu.com/novelapi/api/?time=-10
読了時間が10分以内の小説の小説情報を取得するURLです。


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


http://api.syosetu.com/novelapi/api/?ncode=n0001a-n1111b-n9999d
N0001A,N1111B,N9999Dを取得するURLです。


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


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

注意
本機能は試験提供機能です。マージンを設けてあるため、適切な結果でない場合があります。


http://api.syosetu.com/novelapi/api/?buntai=4-6
字下げが適切に行われている作品


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

長期連載停止中の定義
未完結の連載中小説で最終掲載日から63日以上経過しているものをさします。
検索結果に反映されるまで約15分~2時間の遅れがあります。

http://api.syosetu.com/novelapi/api/?stop=1
長期連載停止中を除外するURLです。


    ▽ピックアップ指定
パラメータ 説明
ispickup int ピックアップ条件に当てはまるかの指定ができます。
 1:最終掲載日(general_lastup)から60日以内でなおかつ「短編または完結済または10万文字以上の連載中」
 0:上記ピックアップ条件を満たさない作品

注意
小説家になろうのピックアップはispickupが1でさらに小説評価が高い順200件です。
小説家になろうのピックアップと同一結果を取得したい場合はispickupが1であるかを確認し、さらに総合評価で並べ替えその結果を200件取得する必要があります。

http://api.syosetu.com/novelapi/api/?ispickup=1&order=hyoka&lim=200
小説家になろうで使っている小説ピックアップの情報を取得するURLです。


    ▽最終掲載日指定
パラメータ 説明
lastup string 最終掲載日(general_lastup)で抽出できます。以下の文字列を指定できます。
 thisweek:今週(日曜日の午前0時はじまり)
 lastweek:先週
 sevenday:過去7日間(7日前の午前0時はじまり)
 thismonth:今月
 lastmonth:先月

タイムスタンプで指定
 開始日と終了日をハイフン(-)記号で区切ることでUNIXタイムスタンプで抽出できます。
 UNIXタイムスタンプとは1970年1月1日からの通算秒数のことです。


http://api.syosetu.com/novelapi/api/?lastup=thisweek
今週新規投稿または次話投稿された作品の一覧です。

http://api.syosetu.com/novelapi/api/?lastup=1262271600-1264949999
2010年1月1日0時0分0秒から2010年1月31日23時59分59秒までに新規投稿または次話投稿された作品を抽出できます。UNIXタイムスタンプで指定しています。


・出力

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)+評価点)
fav_novel_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
f:fav_novel_cnt
r:review_cnt
a:all_point
ah:all_hyoka_cnt
sa:sasie_cnt
ka:kaiwaritu
nu:novelupdated_at
ua:updated_at


http://api.syosetu.com/novelapi/api/?of=t-w&ncode=n0001a
N0001Aのタイトルと作者名を取得するURLです。tとnを指定しています。

http://api.syosetu.com/novelapi/api/?of=ga&ncode=n0001a
N0001Aの全掲載部分数を取得するURLです。

※注意:ntを指定した場合、novel_typeではなくnoveltypeと_(アンダーバー)無しで出力される仕様となっております。ご注意下さい。

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

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


http://api.syosetu.com/novelapi/api/?opt=weekly
週間ユニークユーザを含めて出力します。

http://api.syosetu.com/novelapi/api/?sasie=1-&opt=weekly
挿絵が1枚以上存在する作品を、週間ユニークユーザを含めて出力します。

Atomフィードの特例
out=atomを選択された場合のみ、出力制限があります。
タイトルとURL、あらすじ、最終掲載日、コメントの中に作者ID/作者名のみが出力されています。その他の項目(評価点やキーワードなど)は出力しません。


・時刻の注意

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

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


・利用制限

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


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


企画&運営
HinaProject Inc.