バージョン:1.0
1.レストラン情報取得APIa.リクエストURL
http://api.tabelog.com/Ver1/RestaurantSearch/?パラメータ名=パラメータ値・・・・
b.リクエストパラメータ
パラメータ名は大文字小文字を区別し、パラメータ値は大文字小文字の区別はありません。
結果は20件ずつ返します。
緯度経度、都道府県、最寄り駅はそれぞれ指定した場合、AND条件として検索されます。
*パラメータの指定が無い場合は「デフォルト値」となります。
結果は20件ずつ返します。
緯度経度、都道府県、最寄り駅はそれぞれ指定した場合、AND条件として検索されます。
*パラメータの指定が無い場合は「デフォルト値」となります。
| パラメータ名 | 説明 | データ型 | 値、サンプル | デフォルト値 |
| Latitude | 緯度(日本国内のみ) | Float | (例)35.684 | null |
| Longitude | 経度(日本国内のみ) | Float | (例)139.756 | null |
| Datum | 測地系 (緯度、経度が指定されている時のみ有効) |
String | tokyo world |
world |
| SearchRange | 検索範囲 (緯度、経度が指定されている時のみ有効) | String | smallmediumlarge | medium |
| Prefecture | 都道府県 | String | 別表1 | japan |
| Station | 最寄り駅の駅名 | String | 駅名をURLエンコードしたもの (文字コードはUTF-8) | null |
| ResultSet | 結果形式 | String | smalllarge | small |
| SortOrder | ソート順 | String | totalscore (総合評価高い順) taste (料理・味評価高い順) service (サービス評価高い順) mood (雰囲気評価高い順) highprice (価格(夜)高い順) lowprice (価格(夜)低い順) reviewcount (レビュー数多い順) | totalscore |
| PageNum | ページ数 (最大100ページまで) | Integer | (例)10 | 1 |
| ResultDatum | 結果形式(緯度経度の測地系) | String | tokyo world |
world |
※別表1 都道府県パラメータ表
| パラメータ値 | 説明 |
| hokkaido | 北海道 |
| aomori | 青森 |
| iwate | 岩手 |
| miyagi | 宮城 |
| akita | 秋田 |
| yamagata | 山形 |
| fukushima | 福島 |
| ibaraki | 茨城 |
| tochigi | 栃木 |
| gunma | 群馬 |
| saitama | 埼玉 |
| chiba | 千葉 |
| tokyo | 東京 |
| kanagawa | 神奈川 |
| niigata | 新潟 |
| toyama | 富山 |
| ishikawa | 石川 |
| fukui | 福井 |
| yamanashi | 山梨 |
| nagano | 長野 |
| gifu | 岐阜 |
| shizuoka | 静岡 |
| aichi | 愛知 |
| mie | 三重 |
| shiga | 滋賀 |
| kyoto | 京都 |
| osaka | 大阪 |
| hyogo | 兵庫 |
| nara | 奈良 |
| wakayama | 和歌山 |
| tottori | 鳥取 |
| shimane | 島根 |
| okayama | 岡山 |
| hiroshima | 広島 |
| yamaguchi | 山口 |
| tokushima | 徳島 |
| kagawa | 香川 |
| ehime | 愛媛 |
| kochi | 高知 |
| fukuoka | 福岡 |
| saga | 佐賀 |
| nagasaki | 長崎 |
| kumamoto | 熊本 |
| oita | 大分 |
| miyazaki | 宮崎 |
| kagoshima | 鹿児島 |
| okinawa | 沖縄 |
| japan | 全国 |
c.リターンパラメータ
検索されたレストラン情報をXML形式で返します。(文字コードはUTF-8)
| パラメータ名 | 説明 | データ型 | 対応ResultSet |
| RestaurantName | レストラン名 | String | smallとlarge |
| TabelogUrl | レストラン詳細ページのURL | String | smallとlarge |
| TotalScore | 総合評価 | Float | smallとlarge |
| TasteScore | 料理・味の評価 | Float | smallとlarge |
| ServiceScore | サービスの評価 | Float | smallとlarge |
| MoodScore | 雰囲気の評価 | Float | smallとlarge |
| Situation | シチュエーション | String | smallとlarge |
| DinnerPrice | 価格(夜) | String | smallとlarge |
| LunchPrice | 価格(昼) | String | smallとlarge |
| Category | カテゴリ名 | String | smallとlarge |
| Station | 最寄り駅 | String | smallとlarge |
| Address | 住所 | String | large |
| Tel | 電話番号 | String | large |
| BusinessHours | 営業時間 | String | large |
| Holiday | 休日 | String | large |
| Latitude | 緯度 (ResultDatumが「world」のとき世界測地系 ResultDatumが「tokyo」のとき日本測地系) |
Float | large |
| Longitude | 経度 (ResultDatumが「world」のとき世界測地系 ResultDatumが「tokyo」のとき日本測地系) |
Float | large |
d.サンプル
e.エラー
価格.com 商品検索APIと同じエラーコードを使用しています。
f.注意点
サイト構築の際には、リターンパラメータのTabelogUrlで返されるレストランURLを使用して、必ず食べログへリンクしてください。
g.バージョン
各バージョンのリクエストURLは http://api.tabelog.com/Ver1/・・・・ のVerの後の数字を入れ替たものになります。(例:バージョン1.1 → http://api.tabelog.com/Ver1.1/・・・・)
Version 1.1
リターンパラメータに「NumOfResult」を追加し、検索結果件数が返るようにしました。
リターンパラメータに「NumOfResult」を追加し、検索結果件数が返るようにしました。

