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

なろう小説インラインサーチウィジェット(Novel Inline SearcH)

なろう小説インラインサーチ(NISH)は小説検索結果をホームページやブログに埋め込めるウィジェットです。
注意:このウィジェットでは18禁小説は取得できません

なろう小説インラインサーチは小説検索ページを自由にカスタマイズ、ブログやホームページにインラインフレームで埋め込むことが可能です。

・出力サンプル

サンプル1


▲上記のような感じで検索結果を埋め込めます。

サンプル2
・ジャンル:ハイファンタジー〔ファンタジー〕・連載中小説のみ・新着順・30件を表示



サンプル3
・iframeタグとGETパラメータを利用することでブログパーツとしての利用も可能です。

白 
黒 

・ウィジェットURL

https://dev.syosetu.com/nish/sh/

すべてGETで送信。POSTでは受信できません。
日本語などマルチバイト文字送信時は文字コードをUTF-8にし、URLエンコードしてください。
下記のようにインラインフレームのsrc=""の部分にURLを指定してください。

<iframe src="https://dev.syosetu.com/nish/sh/" width="100%" frameborder=0 height="500" ></iframe>

▽インラインフレームとは?
インラインフレームを使うことで、自身のサイトに別のページを表示できます。
なろう小説インラインサーチウィジェットのURLを指定することで、 自身のサイト内に小説検索結果を埋め込めます。 src="" の中にはURLを、width=""やheight=""を指定することで、検索結果の大きさを指定できます。frameborder=0を指定することで、境界線を消して一体化できます。インラインフレームに関する詳細はHTMLタグの解説サイトなどをご覧ください。

・出力指定GETパラメータ


    ▽色指定
パラメータ 説明
bgcolor string 背景色を指定できます。ccccccのように16進数形式でHTMLカラーコードを指定してください。指定しない場合は白(ffffff)になります。
textcolor string 文字色を指定できます。000000のように16進数形式でHTMLカラーコードを指定してください。指定しない場合は黒(000000)になります。
linkcolor string リンク文字色(未訪問)を指定できます。0000ffのように16進数形式でHTMLカラーコードを指定してください。指定しない場合は青(0000ff)になります。
vlinkcolor string リンク文字色(訪問済)を指定できます。800080のように16進数形式でHTMLカラーコードを指定してください。指定しない場合は紫(800080)になります。
alinkcolor string リンク文字色(選択中)を指定できます。ff0000のように16進数形式でHTMLカラーコードを指定してください。指定しない場合は赤(ff0000)になります。

    ▽基本設定
パラメータ 説明
lim int(1~50) 最大出力数を指定できます。最低1、最高50です。
半角数字で指定してください。
指定しない場合は20件になります。
p int(1~) ページ番号を指定できます。半角数字で指定してください。
navi int(0~1) 一部のテンプレートのみページ移動用リンクの表示を指定できます。
0:表示しない
1:表示する。
指定しない場合は1、表示するになります。
order string 出力順序を指定できます。
指定しない場合は新着順となります。

allunique 閲覧者の多い順(注意:未実装)
favnovelcnt ブックマーク数の多い順
reviewcnt レビュー数の多い順
hyoka 総合評価の高い順
impressioncnt 感想の多い順
hyokacnt 評価者数の多い順
weekly 週間ユニークユーザの多い順
毎週火曜日早朝リセット
(前週の日曜日から土曜日分)
lengthdesc 小説本文の文字数が多い順
lengthasc 小説本文の文字数が少ない順
old 古い順
rand ランダムで表示
tpl string 使用するテンプレートを指定できます。
・何も指定しなかった場合
小説情報の一覧が表示されます。
特にデザインなどは行われていません。

・1_1
出力サンプルのサンプル2で使用しているテンプレートです。(推奨幅:500px以上)

・1_2
小説家になろうの検索ページに準拠したテンプレートです。(推奨幅:780px以上)

・2_1
出力サンプル1並びに3で使用しているテンプレートです。
ページ上部に小説家になろうへのリンクが表示されます。
小説家になろうの下にあるラインの色は変更できません。

・2_2
出力サンプルの3で使用しているテンプレートです。(右側)
ページ上部に小説家になろうへのリンクが表示されます。
小説家になろうの下にあるラインの色は文字色と同じものが設定されます。


・条件抽出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コードから小説を探します。

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


https://dev.syosetu.com/nish/sh/?genre=302
ジャンルがヒューマンドラマ〔文芸〕となっている小説の小説情報を取得するURLです。

例2
https://dev.syosetu.com/nish/sh/?genre=102-201
ジャンルが現実世界〔恋愛〕またはハイファンタジー〔ファンタジー〕となっている小説の小説情報を取得する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:
ノンジャンル〔ノンジャンル〕


https://dev.syosetu.com/nish/sh/?notgenre=304
ジャンルが推理〔文芸〕となっている小説以外の小説情報を取得するURLです。

https://dev.syosetu.com/nish/sh/?notgenre=303-202
ジャンルが歴史〔文芸〕あるいはローファンタジー〔ファンタジー〕となっている小説以外の小説情報を取得するURLです。


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


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

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

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

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


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


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

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

https://dev.syosetu.com/nish/sh/?kaiwaritu=50-
会話率が50%以上の作品を抽出します。

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


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


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

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

https://dev.syosetu.com/nish/sh/?sasie=30
挿絵が3つの作品を抽出します。


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


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

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

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

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


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


https://dev.syosetu.com/nish/sh/?ncode=n0001a-n1111b-n9999d
N0001A,N1111B,N9999Dを取得するURLです。


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


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

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


https://dev.syosetu.com/nish/sh/?buntai=4-6
字下げが適切に行われている作品


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

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

https://dev.syosetu.com/nish/sh/?stop=1
長期連載停止中を除外するURLです。


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

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

https://dev.syosetu.com/nish/sh/?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日からの通算秒数のことです。


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

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



・利用制限

基本的に利用制限はありませんが、小説家になろうグループのほかのページと同様で、 一人の利用者から連続した接続を確認した場合、利用者のIPアドレス単位で一時的にアクセス規制することがあります。

・遅延について

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

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

・おまけ

条件抽出GETパラメータは「小説を読もう!」やなろう小説APIでも利用することができます。
たとえば、https://yomou.syosetu.com/search.php?genre=1とすれば
文学だけを抽出した小説一覧が得られます。
(一部で処理方法を変えており、完全な互換性を維持しているわけではありません)


企画&運営
HinaProject Inc.