利用実績No.1のリフォーム業者選びサイト［登録会員数249,284名］
住まいのリフォーム見積もり相談ならホームプロ

会員ページへ

ホームプロトップ > リフォーム事例検索API

リフォーム事例検索API（開発者様向けページ）

「ホームプロ リフォーム事例検索API」を利用すると、外部のアプリケーションから「ホームプロ」のリフォーム事例データベース（約13000件）の情報を利用することができます。当APIでは、リフォーム工事の価格帯、施工地（都道府県）、キーワードなど様々な検索条件によって抽出された事例データがXML形式で返却されます。ぜひ、あなたのアイデアで価値あるサービスを創ってください。

2010.7.27.
複数キーワードでの検索ができるようになりました。（検索クエリ欄をご覧ください）
2010.6.17.
新しい部位「収納」が追加されました。（検索クエリ欄をご覧ください）
2010.2.3.
新しい部位「和室」が追加されました。（検索クエリ欄をご覧ください）
2009.9.24.
APIを公開しました。マッシュアップコンテスト「Mashup Awards 5」に参加しました。


API仕様

概要
リクエストURL http://webservice.homepro.co.jp/webservice/jirei_part/v1/
リクエスト形式 REST
レスポンス形式 XML
備考 ご利用にはアカウント発行後に取得できるAPIキーが必要です。
ガイドラインを確認の上、アカウント発行申込みページ（無料）からお申し込みください。
検索クエリ
パラメータ名意味概要
hometype家屋形態0：戸建、1：マンション
part部位0-3：キッチン/台所、4-7：浴室/風呂、8：トイレ、9：洗面、10：リビング、11：ダイニング、12：寝室、13：玄関、14：廊下、15：外壁、16：屋根、17：窓/サッシ、18：バルコニー、19：ガーデニング、20：外構/エクステリア、21：階段、22：その他、23：和室、24：収納
from施工金額下限「万円」単位で指定
to施工金額上限「万円」単位で指定
keywordキーワード該当事例に含まれるキーワードで検索できます
カンマ区切りでの複数ワード検索可
※and条件 (例　リフォーム,屋根）
URLエンコードした上でリクエストしてください
pref都道府県ID都道府県コード（01〜47）にて指定
start出力開始件数検索結果の何件目から出力するかを指定
count出力件数1〜100の整数で指定。デフォルトは 10件
sortソート順1：新着順、2：価格の高いもの順、3：価格の低いもの順、4：おすすめ順。デフォルトは 4：おすすめ順
api_keyAPIキーアカウント発行申込みページで発行します
※このパラメータのみ必須です
レスポンスフィールド
フィールド名意味概要
results
  api_versionAPIバージョンAPIのバージョンを示します
  results_available全件数クエリー条件にマッチする、検索結果の全件数
  results_returned返却件数レスポンスに含まれる検索結果の件数
  results_start開始件数検索結果の開始位置
  jirei[複数要素]ここからが事例データ本体です
    jirei_part_id部位事例ID該当事例を一意に示すID
    hometype_name家屋形態家屋形態名称
    hometype_id家屋形態ID家屋形態をIDで示します
    part_name部位名該当事例の部位名称
    part_id部位ID該当事例の部位をIDで示します
    price施工金額施工金額
    menseki面積施工対象面積
    pref_name都道府県施工地の都道府県名
    pref_id都道府県ID施工地の都道府県ID（都道府県コード）
    city_name市区町村名施工地の市区町村名
    comment1コメント説明コメント（HTMLタグ入り）
    photo1_url写真写真URL（コメント1に対応）
    url詳細画面URL各事例の詳細画面URL
    zentai_url全体概要URL各事例がひもづく全体概要画面（複数の部位単位の事例を統べる画面）のURL
サンプルクエリ
東京都のマンションの事例を検索する場合 （*部分はご自身のAPIキーをご利用ください）
http://webservice.homepro.co.jp/webservice/jirei_part/v1/?api_key=*****&hometype=1&pref=13

サンプルレスポンス
こちらのサンプルXMLファイルをご覧ください。

サンプルコード・活用事例

API利用サンプル
http://labs.allreform.com/sample.php

※活用事例募集中！掲載ご希望の方はお問い合わせ画面よりお知らせください。
  （都合により掲載できない場合もございます。）

ガイドライン

当APIをご利用頂く前に、以下の項目を必ずご確認ください。ガイドライン・利用規約に違反した場合はアカウントを停止する場合もございます。

・API利用規約、プライバシーポリシーにご同意ください。
・各事例ごとにURL欄で示された詳細画面へのリンクを設置してください。
・事例データを改変したり、コメント欄に埋め込まれたリンクを削除しないでください。
・法人様によるご利用の場合は、場合によってはご利用を御遠慮頂く場合もございます。
・APIを利用するアプリケーションには、下記のいずれかのクレジットを掲示してください。
表示内容クレジット用HTML
1画像形式　135px × 17px
ホームプロ リフォーム事例検索API
2画像形式　88px × 35px
ホームプロ リフォーム事例検索API
3テキスト形式
ホームプロ リフォーム事例検索API

アカウント発行申込み

上記ガイドラインおよびAPI利用規約・プライバシーポリシーを確認の上、
アカウント発行申込みページ（無料）からお申し込みください。