格言 名言集 - 言霊.in

言霊.inでは、国内最大級の名言データベースを全てAPIで公開しております。マッシュアップして頂いたサイト様には 使用例としてこのページにリンクを載せますので、コンタクトフォームからぜひご連絡ください。

検索API

言霊.inのデータベースにある名言や著者を検索する事ができます。

名言検索

用途

指定した単語を含む名言を取得します。

URL

http://www.kotodama.in/api/search/[検索文字列（URLエンコード済み）]

返り値フォーマット

JSON

返り値の構造

{ { "query"=>"名言本体", "query_kana"=>"名言かな", "query_url"=>"名言へのURL", "author"=>"著者名", "author_kana"=>"著者名かな", "authot_url"=>"著者ページへのリンク" } ... }

サンプルコード

※PHP5.2以降のみ動作します
function searchQuote($query){ //検索条件のURLエンコード $query = urlencode($query); $url = "http://www.kotodama.in/api/search/{$query}"; //APIの呼び出し $json = file_get_contents($url,"r"); //JSONデータのデコード $result = json_decode($json); return $result; } //起業に関する名言の取得 $result = searchQuote('起業');

備考

検索結果が20件以上の場合は、検索対象の名言からランダムに20件取得して返します。その関係で並び順も常にランダムです。

著者検索

用途

指定した単語を含む著者を取得します。

URL

http://www.kotodama.in/api/search/[検索文字列（URLエンコード済み）]/2

返り値フォーマット

JSON

返り値の構造

{ { "author"=>"著者名", "author_kana"=>"著者名かな", "authot_url"=>"著者ページへのリンク" } ... }

サンプルコード

※PHP5.2以降のみ動作します
function searchAuthor($query){ //検索条件のURLエンコード $query = urlencode($query); $url = "http://www.kotodama.in/api/search/{$query}/2"; //APIの呼び出し $json = file_get_contents($url,"r"); //JSONデータのデコード $result = json_decode($json); return $result; } //相田みつをが存在するかどうかチェック $result = searchAuthor('相田みつを');

備考

検索結果が20件以上の場合は、検索対象の名言からランダムに20件取得して返します。その関係で並び順も常にランダムです。

名言取得API

言霊.inの名言をくまなく取得する事ができます。

特定の著者の名言の取得

用途

言霊.inに存在する特定の著者の名言をリストで取得します。

URL

http://www.kotodama.in/api/quoteByAuthor/[著者名（URLエンコード済み）]/[１ページの名言数]/[ページ番号]
[１ページの名言数]は省略可能です。省略時は20がセットされます。最大値は100です。
[ページ番号]は省略可能です。省略時は1がセットされます。

返り値フォーマット

JSON

返り値の構造

{ "count"=>"名言数", "data"=> { { "query"=>"名言本体", "query_kana"=>"名言かな", "query_url"=>"名言へのURL", "author"=>"著者名", "author_kana"=>"著者名かな", "authot_url"=>"著者ページへのリンク" } ... } }

サンプルコード

※PHP5.2以降のみ動作します
function getQuotesOfAuthor($name,$numRows = 20,$page = 1){ //検索条件のURLエンコード $name = urlencode($name); $url = "http://www.kotodama.in/api/quoteByAuthor/{$name}/{$numRows}/{$page}"; //APIの呼び出し $json = file_get_contents($url,"r"); //JSONデータのデコード $result = json_decode($json); return $result; } //相田みつをの名言を取得（20件で3ページ目） $result = getQuotesOfAuthor('相田みつを',20,3);

今日の名言の取得

用途

今日の名言を取得します。

URL

http://www.kotodama.in/api/quoteOfDay

返り値フォーマット

JSON

返り値の構造

{ "query"=>"名言本体", "query_kana"=>"名言かな", "query_url"=>"名言へのURL", "author"=>"著者名", "author_kana"=>"著者名かな", "authot_url"=>"著者ページへのリンク" }

サンプルコード

※PHP5.2以降のみ動作します
function getQuoteOfDay(){ $url = "http://www.kotodama.in/api/quoteOfDay"; //APIの呼び出し $json = file_get_contents($url,"r"); //JSONデータのデコード $result = json_decode($json); return $result; } //今日の名言を取得 $result = getQuoteOfDay();