smatch/api/apartment

物件情報検索API

登録されている物件の一覧を取得します。

スマッチ！ Webサービス

api URL

api url
http://api.smatch.jp/apartment/
format
json / jsonp / xml
method
GET
認証
ApiKey
実行制限
なし
公式ドキュメント
http://webservice.recruit.co.jp/smatch/reference.html#a1to

parameter set

parameter value 省略 説明
key
MyApiKey-key をセット 		必須 APIキー。アカウント登録時に取得したキー。
[MyApiKey-key]を指定すると、Apiキーを預けるで設定されたApiキーに自動変換します。
area 可 エリアコード。下記コードまたはエリアマスタAPIを参照。
030 関東
050 東海
060 関西
999 その他
pref 可 都道府県コード。
city 可 市郡区コード。
line_area 可 沿線方面コード。
line 可 沿線コード。
station 可 駅コード。複数指定は本家ドキュメント参照。
keyword 可 検索キーワード。空白区切りで複数指定可能。
apartment 可 物件ID。
apartment_type 可 物件種別。省略時はすべて。複数指定は本家ドキュメント参照。
010 新築マンション
011 中古マンション
price_mitei 可 価格が未定の物件を含めるかどうか。省略時は含める。
price_min 可 物件価格下限。1000～10000の範囲の整数。
1000=1000万。
price_max 可 物件価格上限。2000～12000の範囲の整数。
1000=1000万。
area_min 可 専有面積下限。20～100の範囲の整数。（※単位不明だがおそらく㎡。）
area_max 可 専有面積上限。20～100の範囲の整数。
madori 可 間取り。複数指定は本家ドキュメント参照。
1 ワンルーム
2 1K/DK/LDK
3 2K/DK/LDK
4 3K/DK/LDK
5 4K/DK/LDK
6 5K以上
access 可 最寄駅またはバス停までの時間。（※おそらく徒歩）
year_built 可 物件の築年数。
newly 可 新着。省略時はすべて。
lat_from 可 経度。(lat_from < lat_to)世界測地系。※本家ドキュメント参照。
lng_from 可 緯度。(lat_from < lng_to)世界測地系。※本家ドキュメント参照。
lat_to 可 経度。世界測地系。※本家ドキュメント参照。
lng_to 可 緯度。世界測地系。※本家ドキュメント参照。
order 可 並び順。省略時は閲覧数多い順。
start 可 取得開始位置。省略時は1。
count 可 1ページあたりの取得件数。1～100の範囲。省略時は10。
format 可 出力形式。

取得形式 :

call results

[call update]ボタンを押してください。ここに結果が表示されます。

  • このデータは、jsonpで取得しjabascriptオブジェクトに変換されたものを再度json形式に変換した結果です。
  • 受信されるデータと厳密に同じでないことをご理解ください。

発行したAPIのURLとパラメータ

下記のURLで、本ページの各パラメータに自動的にセットされます。

開発メンバー間でパラメータの指定例をメールで送信したり、ブログやホームページでApiの説明を書く際にお使いください。
※パラメータにApiキーなどが含まれる場合はご注意ください。

  • javascriptでは桁数の大きな数値で値がズレることがあります。
  • 例えば、twitterの id_str と id です。
  • id_str は文字列型ですので正しい値が表示されます。
  • id は数値型です。桁数が大きな場合、 +-1のズレが発生することがあります。
  • id_str と id が異なる場合は、id_str を信用してください。
  • 試しに下記をクリックして実行してみてください。期待する値がalertされるでしょうか？
  • javascript:eval('var a = 13782936788668417, b = \'13782936788668417\';'); alert(a+' : 数値型'+'\n\n'+b+' : 文字列型');
  • 本サイトでは、javascriptで処理をしている関係上、apiから取得してきたデータと異なることがあります。
  • あらかじめご理解・ご了承ください。