価格コム WEBサービス API マニュアル

バージョン:1.0
1.レストラン情報取得API
a.リクエストURL
http://api.tabelog.com/Ver1/RestaurantSearch/?パラメータ名=パラメータ値・・・・
b.リクエストパラメータ
パラメータ名は大文字小文字を区別し、パラメータ値は大文字小文字の区別はありません。
結果は20件ずつ返します。
緯度経度、都道府県、最寄り駅はそれぞれ指定した場合、AND条件として検索されます。
*パラメータの指定が無い場合は「デフォルト値」となります。
 
パラメータ名 説明 データ型 値、サンプル デフォルト値
Latitude 緯度(日本国内のみ) Float (例)35.684 null
Longitude 経度(日本国内のみ) Float (例)139.756 null
Datum 測地系
(緯度、経度が指定されている時のみ有効)
String tokyo
world
world
SearchRange 検索範囲
(緯度、経度が指定されている時のみ有効)
String small
medium
large
medium
Prefecture 都道府県 String 別表1 japan
Station 最寄り駅の駅名 String 駅名をURLエンコードしたもの
(文字コードはUTF-8)
null
ResultSet 結果形式 String small
large
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.サンプル
リクエスト
http://api.tabelog.com/Ver1/RestaurantSearch/?Latitude=35.701&Longitude=139.754& Datum=world&SearchRange=small&Prefecture=tokyo& Station=%E6%B0%B4%E9%81%93%E6%A9%8B&ResultSet=large& SortOrder=totalscore&PageNum=1
の場合。
結果
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」を追加し、検索結果件数が返るようにしました。