ネコサーチAPI

ネコサーチの最新投稿を外部サービスでも手軽に扱えるように、JSON APIをご用意しました。
リクエストされたURLのクエリ条件に見合う、最新10件の情報を返します。
ぜひご利用ください。

使い方

リクエストURLは下記になります。

https://api.neko-search.com/v1/?type=(search|protect)&area=(都道府県名)

type

'search'(探されている猫の情報)、もしくは'protect'(保護されている猫)を記述してください。
type自体の指定がない場合は両方を含むデータが返されます。

area

都道府県名を記述してください。
名称は○○県や○○府など、都道府県の文字まで記述してください。
area自体の記述がない場合は全都道府県を含むデータが返されます。

受け取れるデータ

  • site_url : その情報が記載されているネコサーチ上のページURL
  • name : 猫の名前(保護されている猫の場合、空文字)
  • area : 都道府県 市区郡 町村
  • best_feature : 特徴
  • body_color : 体毛の色(記載がない場合、空文字)
  • eye_color : 瞳の色(記載がない場合、空文字)
  • pict_url : 投稿された画像のURL

使用例(PHP)

<?php
  $json = file_get_contents('https://api.neko-search.com/v1/?type=search&area=東京都');
  $obj = json_decode($json, true);

  // var_dump($obj);
  /*
   * array(1) {
   *   ["units"]=>
   *   array(10) {
   *     [0]=>
   *     array(7) {
   *       ["site_url"]=>
   *       string(41) "https://www.neko-search.com/unit.php?id=○○"
   *       ["name"]=>
   *       string(9) "○○○"
   *       ["area"]=>
   *       string(36) "東京都○○区○○町"
   *       ["best_feature"]=>
   *       string(42) "○○○○○○○○"
   *       ["body_color"]=>
   *       string(24) "○○○○"
   *       ["eye_color"]=>
   *       string(9) "○○○○"
   *       ["pict_url"]=>
   *       string(73) "https://www.neko-search.com/img/units/○○○○.jpg"
   *     }
   *     [1]=>
   *     array(7) {
   *       ["site_url"]=>
   *       string(41) "https://www.neko-search.com/unit.php?id=○○"
   *       ["name"]=>
   *       string(9) "○○○"
   *       ["area"]=>
   *       string(36) "東京都○○市○○"
   *       ["best_feature"]=>
   *       string(42) "○○○○○○○○"
   *       ["body_color"]=>
   *       string(24) "○○○○"
   *       ["eye_color"]=>
   *       string(9) "○○○○"
   *       ["pict_url"]=>
   *       string(73) "https://www.neko-search.com/img/units/○○○○.jpg"
   *     }
----------
   *     [9]=>
   *     array(7) {
   *       ["site_url"]=>
   *       string(41) "https://www.neko-search.com/unit.php?id=○○"
   *       ["name"]=>
   *       string(9) "○○○"
   *       ["area"]=>
   *       string(36) "東京都○○区○○町"
   *       ["best_feature"]=>
   *       string(42) "○○○○○○○○"
   *       ["body_color"]=>
   *       string(24) "○○○○"
   *       ["eye_color"]=>
   *       string(9) "○○○○"
   *       ["pict_url"]=>
   *       string(73) "https://www.neko-search.com/img/units/○○○○.jpg"
   *     }
   *   }
   * }
   */
?>

ご利用規約

以下に記載する内容以外は本サイトの利用規約に準じます。

  • APIを利用して取得した情報に限り、私的利用の範囲外の利用を許可致します。
  • APIを利用して取得した情報に限り、営利を目的としたサイトやサービス上での利用を許可致します。
  • APIを利用して受け取れるデータに投稿者様の個人情報は含まれておりませんが、取り扱いには十分にご配慮ください。
  • 本サイトと同種のサービスを提供されている方については、より使いやすい形でご提供出来るかもしれませんので、お問い合わせよりご相談ください。