ロケタッチグルメ についての wiki です



アクセス

http://api.gourmet.livedoor.com/VERSION/CONTENT/?api_key=API_KEY&QUERY
  • API_KEY
    • 発行されたAPI利用キー
  • VERSION
    • API のバージョン 【現在のバージョンは v1.0 です
  • CONTENT
    • restaurant -> お店検索API
    • evaluation -> 口コミ検索API
    • photo -> 写真検索API
    • pref -> 都道府県マスターAPI
    • area -> エリアマスターAPI
    • station -> 駅マスターAPI
    • category -> カテゴリマスターAPI
  • QUERY
    • 検索パラメータ

お店検索API - Restaurant Search API

http://api.gourmet.livedoor.com/v1.0/restaurant/?api_key=API_KEY
  • 1ページ10件固定

検索クエリー

クエリー項目説明値、例
api_keyAPIキーロケタッチグルメAPI利用登録時に発行されたキーをセットします。(必須)40byteの文字列
item_idお店IDロケタッチグルメで割り当てられているお店ごとのIDで検索します。整数 ex)22702
pref_id都道府県IDロケタッチグルメで割り当てられている都道府県IDで検索します。都道府県IDマスタ参照
area_idエリアIDロケタッチグルメで割り当てられているエリアIDで検索します。エリアIDマスタ参照
station_id駅IDロケタッチグルメで割り当てられている駅ごとのIDで検索します。駅IDマスタ参照
category_idカテゴリIDロケタッチグルメで割り当てられている各ジャンル(カテゴリ)のIDで検索します。カテゴリIDマスタ参照
name店名店名から検索します。(部分一致)uriエンコードされた文字列(utf8)
address住所住所から検索します。(部分一致)uriエンコードされた文字列(utf8)
sortソート検索結果をソートします。total: 総合
food: 料理
service: サービス
atmosphere: 雰囲気
cost_performance: コストパフォーマンス
comment_count: コメント数
date: 新着(初期値)
orderソート順ソート順を指定します。1: 昇順
0: 降順(初期値)
pageページ数ページ数を指定します。整数 ex)100
typeレスポンスタイプ検索結果のフォーマットタイプを xml,json から選択します。
json 指定時、callback の併用で jsonp として動作します。
xml(初期値)
json(+callback)
ex)type=json&callback=function

レスポンスフィールド

フィールド説明
versionAPI のバージョン文字列1.0
current_page現在のページ整数1
entriesこの検索結果の件数整数10
total_entries検索結果の全件数整数1000
restaurant*********
- item_idお店ID整数328080
- name店名文字列和食 ライブドア
- name_kana店名ひらがな文字列わしょく らいぶどあ
- alphabet店名欧文文字列wasyoku livedoor
- property支店名文字列赤坂店
- pref*********
-- name都道府県名文字列東京都
- area*********
-- nameエリア名文字列赤坂
- station*********
-- name駅名文字列溜池山王
-- time時間(分)整数10
-- distance距離(m)整数500
- category*********
-- nameカテゴリ名文字列魚料理
- zip郵便番号文字列123-4567
- address住所文字列港区赤坂2-2-15 AT&T1F
- tel電話番号文字列03-1234-5678
- faxFAX番号文字列03-1234-5678
- urlお店サイトURL文字列(URL)http://wasyoku.livedoor.com/
- closeday*********
-- days休業日文字列
-- note休業日備考文字列
- weekday平日営業文字列11:30 - 14:00(LO 13:30)/18:00 - 23:00(LO 21:30) ランチ 11:30 - 14:00(LO 13:30)
- saturday土曜営業文字列11:30 - 14:00(LO 13:30)/18:00 - 23:00(LO 21:30) ランチ 11:30 - 14:00(LO 13:30)
- holiday休日営業文字列11:30 - 14:00(LO 13:30)/18:00 - 23:00(LO 21:30) ランチ 11:30 - 14:00(LO 13:30)
- openhours_note営業時間備考文字列第1木曜は夜のみ営業(昼休業)
- price_range*********
-- lunchランチに掛かった平均予算文字列3,000〜5,000円
-- dinnerディナーに掛かった平均予算文字列5,000〜10,000円
- purposeお店利用目的文字列デート
- description備考文字列
- count*********
-- commentお店に投稿されたクチコミ数整数100
-- evaluationお店に対する評価者数整数100
-- photoお店に投稿された写真数整数100
-- specialお店が含まれる特集数整数100
-- menuお店に投稿されたメニュー数整数100
-- fanお店がお気に入りなユーザー数整数100
-- accessお店の累計アクセス数整数10000
- average*********
-- total平均評価 - 総合少数(0.0〜5.0)4.9
-- food平均評価 - 料理少数(0.0〜5.0)4.9
-- service平均評価 - サービス少数(0.0〜5.0)4.9
-- atmosphere平均評価 - 雰囲気少数(0.0〜5.0)0.2
-- cost_performance平均評価 - コストパフォーマンス少数(0.0〜5.0)4.9
- north_latitude北緯世界測地系(WGS84) - degree形式36.316172
- east_longitude東経世界測地系(WGS84) - degree形式137.913220
- open*********
-- morningモーニング有文字列あり
-- lunchランチ有文字列なし
-- late23時以降営業文字列なし
- photo*********
-- url写真URL文字列(URL)http://storage.gourmet.livedoor.com/ld_gourmet_sta...
-- captionタイトル文字列焼き魚
-- description説明文字列
- date*********
-- createdお店情報を作成した年月日日付(YYYY-MM-DD)2009-04-01
-- modifiedお店情報を更新した年月日日付(YYYY-MM-DD)2009-04-01
- closed閉店文字列閉店
- hotpepper_couponクーポン(ホットペッパー)文字列あり
- livedoor_idお店登録者 livedoorID文字列ld_gourmet_staff
- permalinkお店詳細リンク文字列(URL)http://gourmet.livedoor.com/restaurant/328080/
- permalink_mobileお店詳細リンク(携帯)文字列(URL)http://gourmet.m.livedoor.com/restaurant/328080/
- trackbackトラックバック文字列(URL)http://gourmet.livedoor.com/trackback/328080/

サンプルxml

<?xml version="1.0" encoding="UTF-8" ?> 
<results>
<version>1.0</version> 
<current_page>1</current_page>
<entries>1</entries>
<total_entries>1</total_entries>
<restaurant>
  <item_id>579</item_id>
  <name>麺屋武蔵</name>
  <name_kana>めんやむさし</name_kana>
  <alphabet />
  <property />
  <pref>
    <id>13</id>
    <name>東京都</name>
  </pref>
  <area>
    <id>3</id>
    <name>新宿</name>
  </area>
  <station>
    <id>2407</id>
    <name>西武新宿</name>
    <time>2</time>
    <distance>142</distance>
  </station>
  <category>
    <id>317</id>
    <name>ラーメン一般</name>
  </category>
  <zip />
  <address>新宿区西新宿7-2-6 K1ビル1F</address>
  <tel>03-3796-4634</tel>
  <fax />
  <url />
  <email />
  <closeday>
    <days />
    <note />
  </closeday>
  <weekday>11:30 - 15:30/16:30 - 21:30</weekday>
  <saturday>11:30 - 15:30/16:30 - 21:30</saturday>
  <holiday>11:30 - 16:30</holiday>
  <openhours_note></openhours_note>
  <price_range>
    <lunch>1,000円以下</lunch>
    <dinner>1,000円以下</dinner>
  </price_range>
  <purpose />
  <description>日曜日は麺切れ終了、閉店時間注意。
新宿駅西口から小滝橋通りへ、徒歩5分</description>
  <count>
    <comment>199</comment>
    <evaluation>324</evaluation>
    <photo>29</photo>
    <special>10</special>
    <menu>2</menu>
    <fan>11</fan>
    <access>27515</access>
  </count>
  <average>
    <total>2.9</total>
    <food>0.0</food>
    <service>0.0</service>
    <atmosphere>0.0</atmosphere>
    <cost_performance>0.0</cost_performance>
  </average>
  <north_latitude>35.695540</north_latitude>
  <east_longitude>139.698674</east_longitude>
  <open>
    <morning>あり</morning>
    <lunch>なし</lunch>
    <late>なし</late>
  </open>
  <photo>
    <url>http://storage.gourmet.livedoor.com/take7211/f/8/f28b76ebf697e4a8-l.jpg</url>
    <caption>麺屋武蔵</caption>
    <description />
  </photo>
  <date>
    <created>2000-11-06</created>
    <modified>2000-11-06</modified>
  </date>
  <closed />
  <hotpepper_coupon>なし</hotpepper_coupon>
  <livedoor_id>tg-tatemura</livedoor_id>
  <permalink>http://gourmet.livedoor.com/restaurant/579/</permalink>
  <permalink_mobile>http://gourmet.m.livedoor.com/restaurant/579/</permalink_mobile>
  <trackback>http://gourmet.livedoor.com/trackback/579/</trackback>
</restaurant>
<copyright>
  <title>Copyright (C) 1996-2009 livedoor Co.,Ltd. All rights reserved.</title>
  <url>http://www.livedoor.com/</url>
</copyright>
</results>

口コミ検索API - Evaluation Search API

http://api.gourmet.livedoor.com/v1.0/evaluation/?api_key=API_KEY
  • 1ページ10件固定

検索クエリー

クエリー項目説明値、例
api_keyAPIキーロケタッチグルメAPI利用登録時に発行されたキーをセットします。(必須)40byteの文字列
item_idお店IDロケタッチグルメで割り当てられているお店ごとのIDで検索します。整数 ex)22702
livedoor_idlivedoorIDロケタッチグルメに登録されているユーザーのlivedoorIDで検索します。文字列 ex)ld_gourmet_staff
sortソート検索結果をソートします。point: 得票数
date: 新着(初期値)
orderソート順ソート順を指定します。1: 昇順
0: 降順(初期値)
pageページ数ページ数を指定します。整数 ex)100
typeレスポンスタイプ検索結果のフォーマットタイプを xml,json から選択します。
json 指定時、callback の併用で jsonp として動作します。
xml(初期値)
json(+callback)
ex)type=json&callback=function

レスポンスフィールド

フィールド説明
versionAPI のバージョン文字列1.0
current_page現在のページ整数1
entriesこの検索結果の件数整数10
total_entries検索結果の全件数整数1000
evaluation*********
- item_idお店ID整数328080
- livedoor_idクチコミ登録者の livedoorID文字列ld_gourmet_staff
- eval*********
-- total評価 - 総合整数(0〜5)5
-- food評価 - 料理整数(0〜5)5
-- service評価 - サービス整数(0〜5)5
-- atmosphere評価 - 雰囲気整数(0〜5)1
-- cost_performance評価 - コストパフォーマンス整数(0〜5)5
- commentクチコミ本文文字列(改行含む)ランチコース(エスペリアコース)でそれぞれ注文。どれも美味しいけど、特にパスタがいい♪ここのパスタは本当に美味しいです。コースとは別でケーキも登場!紫芋のケーキを作っていただきました♪ケーキと一緒にハッピーバースデーのオルゴールまで用意して...
- purposeお店利用目的文字列一人ご飯
- price_range******
-- lunchランチに掛かった平均予算文字列3,000〜5,000円
-- dinnerディナーに掛かった平均予算文字列5,000〜10,000円
- count*********
-- voteクチコミに対する投票数整数666
- date*********
-- createdクチコミを投稿した年月日日付(YYYY-MM-DD)2009-04-01
-- modifiedクチコミを更新した年月日日付(YYYY-MM-DD)2009-04-01
- permalinkクチコミ詳細リンク文字列(URL)http://gourmet.livedoor.com/restaurant/328080/eval...

サンプルxml

<?xml version="1.0" encoding="UTF-8" ?> 
<results>
<version>1.0</version>
<current_page>1</current_page>
<entries>10</entries>
<total_entries>199</total_entries>
<evaluation>
  <item_id>579</item_id>
  <eval>
    <total>2</total>
    <food>3</food>
    <service>3</service>
    <atmosphere>3</atmosphere>
    <cost_performance>2</cost_performance>
  </eval>
  <comment>東京のすしを語るには絶対にはずせない一軒だと思います。まずはネタに対するこだわりよう。

全国各地からご主人が選んできた素晴らしいネタがいつもそろっています。

たとえばうにひとつとっても九州唐津のうにと北海道のうにと同時に2種類は置くこだわりよう。...</comment>
  <purpose>一人ご飯</purpose>
  <price_range>
    <lunch>1,000円以下</lunch>
    <dinner>不明</dinner>
  </price_range>
  <count>
    <vote>0</vote>
  </count>
  <photo />
  <date>
    <created>2009-04-19</created>
    <modified>2009-04-19</modified>
  </date>
  <livedoor_id>h_g_d_i_k1108</livedoor_id>
  <permalink>http://gourmet.livedoor.com/restaurant/579/evaluation/detail/216778/155383/</permalink>
</evaluation>
<evaluation>
  <item_id>579</item_id>
  <eval>
    <total>1</total>
    <food>1</food>
    <service>1</service>
    <atmosphere>1</atmosphere>
    <cost_performance>1</cost_performance>
  </eval>
  <comment>本日20食限定ばらちらしのランチに伺いました。
12時ちょい前入店時はノーゲスト状態。
ランチはばらちらしのみの営業なので、そんなに待つことなく出てきます。...</comment>
  <purpose>友人・同僚と</purpose>
  <price_range>
    <lunch>1,000円以下</lunch>
    <dinner>不明</dinner>
  </price_range>
  <count>
    <vote>0</vote>
  </count>
  <photo />
  <date>
    <created>2009-04-10</created>
    <modified>2009-04-10</modified>
  </date>
  <livedoor_id>myarumyaru</livedoor_id>
  <permalink>http://gourmet.livedoor.com/restaurant/579/evaluation/detail/216072/154690/</permalink>
<copyright>
  <title>Copyright (C) 1996-2009 livedoor Co.,Ltd. All rights reserved.</title>
  <url>http://www.livedoor.com/</url>
</copyright>
</evaluation>

写真検索API - Photo Search API

http://api.gourmet.livedoor.com/v1.0/photo/?api_key=API_KEY
  • 最大5件まで
  • ページング無し

検索クエリー

クエリー項目説明値、例
api_keyAPIキーロケタッチグルメAPI利用登録時に発行されたキーをセットします。(必須)40byteの文字列
item_idお店IDロケタッチグルメで割り当てられているお店ごとのIDで検索します。整数 ex)22702
typeレスポンスタイプ検索結果のフォーマットタイプを xml,json から選択します。
json 指定時、callback の併用で jsonp として動作します。
xml(初期値)
json(+callback)
ex)type=json&callback=function

レスポンスフィールド

フィールド説明
versionAPI のバージョン文字列1.0
current_page現在のページ整数1
entriesこの検索結果の件数整数5
total_entries検索結果の全件数整数5(最大5件)
photo*********
- url写真URL文字列(URL)http://storage.gourmet.livedoor.com/ld_gourmet_sta...
- captionタイトル文字列焼き魚
- description説明文字列

サンプルxml

<?xml version="1.0" encoding="UTF-8" ?> 
<results>
<version>1.0</version> 
<current_page>1</current_page>
<entries>5</entries>
<total_entries>5</total_entries>
<photo>
  <url>http://storage.gourmet.livedoor.com/take7211/2/5/24e1282bf49a1ba5-l.jpg</url>
  <caption>麺屋武蔵</caption>
  <description />
</photo>
<photo>
  <url>http://storage.gourmet.livedoor.com/take7211/f/8/f28b76ebf697e4a8-l.jpg</url>
  <caption>麺屋武蔵</caption>
  <description />
</photo>
<photo>
  <url>http://storage.gourmet.livedoor.com/take7211/9/b/990896d6dc72c9bb-l.jpg</url>
  <caption>麺屋武蔵</caption>
  <description />
</photo>
<photo>
  <url>http://storage.gourmet.livedoor.com/take7211/f/0/f4408f8ebcc6dcf0-l.jpg</url>
  <caption>麺屋武蔵</caption>
  <description />
</photo>
<photo>
  <url>http://storage.gourmet.livedoor.com/take7211/e/9/e676e113e815aa09-l.jpg</url>
  <caption>麺屋武蔵</caption>
  <description />
</photo>
<copyright>
  <title>Copyright (C) 1996-2009 livedoor Co.,Ltd. All rights reserved.</title>
  <url>http://www.livedoor.com/</url>
</copyright>
</results>

都道府県マスターAPI - Prefecture Mater API

http://api.gourmet.livedoor.com/v1.0/pref/?api_key=API_KEY
  • ページング無し
  • 都道府県ID未設定時は都道府県全てのIDを返します

検索クエリー

クエリー項目説明値、例
api_keyAPIキーロケタッチグルメAPI利用登録時に発行されたキーをセットします。(必須)40byteの文字列
pref_id都道府県IDロケタッチグルメで割り当てられている都道府県IDで検索します。整数 ex)13
typeレスポンスタイプ検索結果のフォーマットタイプを xml,json から選択します。
json 指定時、callback の併用で jsonp として動作します。
xml(初期値)
json(+callback)
ex)type=json&callback=function

レスポンスフィールド

フィールド説明
versionAPI のバージョン文字列1.0
current_page現在のページ整数1
entriesこの検索結果の件数整数47
total_entries検索結果の全件数整数47
pref*********
- id都道府県ID整数13(1〜47)
- name都道府県名文字列東京都
- sname都道府県名(省略)文字列東京

サンプルxml

<?xml version="1.0" encoding="UTF-8" ?> 
<results>
<version>1.0</version>
<current_page>1</current_page>
<entries>1</entries>
<total_entries>1</total_entries>
<pref>
  <id>13</id>
  <name>東京都</name>
  <sname>東京</sname>
</pref>
<copyright>
  <title>Copyright (C) 1996-2009 livedoor Co.,Ltd. All rights reserved.</title>
  <url>http://www.livedoor.com/</url>
</copyright>
</results>

エリアマスターAPI - Area Mater API

http://api.gourmet.livedoor.com/v1.0/area/?api_key=API_KEY
  • ページング無し

検索クエリー

クエリー項目説明値、例
api_keyAPIキーロケタッチグルメAPI利用登録時に発行されたキーをセットします。(必須)40byteの文字列
pref_id都道府県IDロケタッチグルメで割り当てられている都道府県IDで検索します。都道府県IDマスタ参照
area_idエリアIDロケタッチグルメで割り当てられているエリアIDで検索します。整数 ex)1
typeレスポンスタイプ検索結果のフォーマットタイプを xml,json から選択します。
json 指定時、callback の併用で jsonp として動作します。
xml(初期値)
json(+callback)
ex)type=json&callback=function

レスポンスフィールド

フィールド説明
versionAPI のバージョン文字列1.0
current_page現在のページ整数1
entriesこの検索結果の件数整数47
total_entries検索結果の全件数整数47
area*********
- idエリアID整数1
- nameエリア名文字列銀座、新橋、有楽町

サンプルxml

<?xml version="1.0" encoding="UTF-8" ?> 
<results>
<version>1.0</version>
<current_page>1</current_page>
<entries>1</entries>
<total_entries>1</total_entries>
<area>
  <id>3</id>
  <name>新宿</name>
</area>
<copyright>
  <title>Copyright (C) 1996-2009 livedoor Co.,Ltd. All rights reserved.</title>
  <url>http://www.livedoor.com/</url>
</copyright>
</results>

駅マスターAPI - Station Mater API

http://api.gourmet.livedoor.com/v1.0/station/?api_key=API_KEY
  • ページング無し

検索クエリー

クエリー項目説明値、例
api_keyAPIキーロケタッチグルメAPI利用登録時に発行されたキーをセットします。(必須)40byteの文字列
area_idエリアIDロケタッチグルメで割り当てられているエリアIDで検索します。エリアIDマスタ参照
station_id駅IDロケタッチグルメで割り当てられている駅IDで検索します。整数 ex)2000
typeレスポンスタイプ検索結果のフォーマットタイプを xml,json から選択します。
json 指定時、callback の併用で jsonp として動作します。
xml(初期値)
json(+callback)
ex)type=json&callback=function

レスポンスフィールド

フィールド説明
versionAPI のバージョン文字列1.0
current_page現在のページ整数1
entriesこの検索結果の件数整数10
total_entries検索結果の全件数整数10
station*********
- id駅ID整数1996
- name駅名文字列銀座
- name_kana駅名ひらがな文字列ぎんざ

サンプルxml

<?xml version="1.0" encoding="UTF-8" ?> 
<results>
<version>1.0</version>
<current_page>1</current_page>
<entries>1</entries>
<total_entries>1</total_entries>
<station>
  <id>2407</id>
  <name>西武新宿</name>
  <name_kana>せいぶしんじゅく</name_kana>
</station>
<copyright>
  <title>Copyright (C) 1996-2009 livedoor Co.,Ltd. All rights reserved.</title>
  <url>http://www.livedoor.com/</url>
</copyright>
</results>

カテゴリマスターAPI - Category Mater API

http://api.gourmet.livedoor.com/v1.0/category/?api_key=API_KEY
  • ページング無し
  • カテゴリID未設定時は大ジャンルを返します

検索クエリー

クエリー項目説明値、例
api_keyAPIキーロケタッチグルメAPI利用登録時に発行されたキーをセットします。(必須)40byteの文字列
category_idカテゴリIDロケタッチグルメで割り当てられているカテゴリIDで検索します。整数 ex)100
typeレスポンスタイプ検索結果のフォーマットタイプを xml,json から選択します。
json 指定時、callback の併用で jsonp として動作します。
xml(初期値)
json(+callback)
ex)type=json&callback=function

レスポンスフィールド

フィールド説明
versionAPI のバージョン文字列1.0
current_page現在のページ整数1
entriesこの検索結果の件数整数10
total_entries検索結果の全件数整数10
category*********
- idカテゴリID整数100
- nameカテゴリ名文字列和食
- name_kanaカテゴリ名ひらがな文字列わしょく

サンプルxml

<?xml version="1.0" encoding="UTF-8" ?> 
<results>
<version>1.0</version>
<current_page>1</current_page>
<entries>1</entries>
<total_entries>1</total_entries>
<category>
  <id>317</id>
  <name>ラーメン一般</name>
  <name_kana>らーめんいっぱん</name_kana>
</category>
<copyright>
  <title>Copyright (C) 1996-2009 livedoor Co.,Ltd. All rights reserved.</title>
  <url>http://www.livedoor.com/</url>
</copyright>
</results>

検索

管理人/副管理人のみ編集できます