なろうデベロッパー

小説家になろう

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

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

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

出力サンプル

サンプル1

上記のようにiframeタグで検索結果を埋め込めます。

サンプル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

出力順序を指定できます。
指定しない場合は新着更新順となります。

  • new
    新着更新順
  • 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

ジャンルを指定できます。ハイフン(-)記号で区切れば複数ジャンルを一括抽出できます。

  • 0
    未選択〔未選択〕
  • 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です。

https://dev.syosetu.com/nish/sh/?genre=102-201

ジャンルが現実世界〔恋愛〕またはハイファンタジー〔ファンタジー〕となっている作品の作品情報を取得するURLです。

ジャンル除外指定

パラメータ 値 説明
notgenre int
string

ジャンルを除外検索できます。ハイフン(-)記号で区切れば含ませたくないジャンルを増やせます。

  • 0
    未選択〔未選択〕
  • 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=3

挿絵が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です。

最終掲載日指定

パラメータ 値 説明
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タイムスタンプで指定しています。

最終更新日指定

パラメータ 値 説明
lastupdate string

最終更新日novelupdated_atで抽出できます。以下の文字列を指定できます。

  • thisweek
    今週(日曜日の午前0時はじまり)
  • lastweek
    先週
  • sevenday
    過去7日間(7日前の午前0時はじまり)
  • thismonth
    今月
  • lastmonth
    先月
  • タイムスタンプ
    開始日と終了日をハイフン(-)記号で区切ることでUNIXタイムスタンプで抽出できます。
    UNIXタイムスタンプとは1970年1月1日からの通算秒数のことです。

https://dev.syosetu.com/nish/sh/?lastupdate=thisweek

今週中に内容が更新された作品の一覧です。

https://dev.syosetu.com/nish/sh/?lastupdate=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=101とすればジャンルが異世界〔恋愛〕の作品だけを抽出した作品一覧が得られます。
ただし、一部で処理方法を変えており、完全な互換性は維持していません。