最終更新: staff_gourmet 2012年01月31日(火) 13:28:17履歴
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
- 検索パラメータ
http://api.gourmet.livedoor.com/v1.0/restaurant/?api_key=API_KEY
- 1ページ10件固定
クエリー | 項目 | 説明 | 値、例 |
api_key | APIキー | ロケタッチグルメ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 |
フィールド | 説明 | 型 | 値 |
version | API のバージョン | 文字列 | 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 |
- fax | FAX番号 | 文字列 | 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 | ランチ有 | 文字列 | なし |
-- late | 23時以降営業 | 文字列 | なし |
- 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 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>
http://api.gourmet.livedoor.com/v1.0/evaluation/?api_key=API_KEY
- 1ページ10件固定
クエリー | 項目 | 説明 | 値、例 |
api_key | APIキー | ロケタッチグルメAPI利用登録時に発行されたキーをセットします。(必須) | 40byteの文字列 |
item_id | お店ID | ロケタッチグルメで割り当てられているお店ごとのIDで検索します。 | 整数 ex)22702 |
livedoor_id | livedoorID | ロケタッチグルメに登録されているユーザーの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 |
フィールド | 説明 | 型 | 値 |
version | API のバージョン | 文字列 | 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 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>
http://api.gourmet.livedoor.com/v1.0/photo/?api_key=API_KEY
- 最大5件まで
- ページング無し
クエリー | 項目 | 説明 | 値、例 |
api_key | APIキー | ロケタッチグルメAPI利用登録時に発行されたキーをセットします。(必須) | 40byteの文字列 |
item_id | お店ID | ロケタッチグルメで割り当てられているお店ごとのIDで検索します。 | 整数 ex)22702 |
type | レスポンスタイプ | 検索結果のフォーマットタイプを xml,json から選択します。 json 指定時、callback の併用で jsonp として動作します。 | xml(初期値) json(+callback) ex)type=json&callback=function |
フィールド | 説明 | 型 | 値 |
version | API のバージョン | 文字列 | 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 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>
http://api.gourmet.livedoor.com/v1.0/pref/?api_key=API_KEY
- ページング無し
- 都道府県ID未設定時は都道府県全てのIDを返します
クエリー | 項目 | 説明 | 値、例 |
api_key | APIキー | ロケタッチグルメAPI利用登録時に発行されたキーをセットします。(必須) | 40byteの文字列 |
pref_id | 都道府県ID | ロケタッチグルメで割り当てられている都道府県IDで検索します。 | 整数 ex)13 |
type | レスポンスタイプ | 検索結果のフォーマットタイプを xml,json から選択します。 json 指定時、callback の併用で jsonp として動作します。 | xml(初期値) json(+callback) ex)type=json&callback=function |
フィールド | 説明 | 型 | 値 |
version | API のバージョン | 文字列 | 1.0 |
current_page | 現在のページ | 整数 | 1 |
entries | この検索結果の件数 | 整数 | 47 |
total_entries | 検索結果の全件数 | 整数 | 47 |
pref | *** | *** | *** |
- id | 都道府県ID | 整数 | 13(1〜47) |
- name | 都道府県名 | 文字列 | 東京都 |
- sname | 都道府県名(省略) | 文字列 | 東京 |
<?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_key | APIキー | ロケタッチグルメ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 |
フィールド | 説明 | 型 | 値 |
version | API のバージョン | 文字列 | 1.0 |
current_page | 現在のページ | 整数 | 1 |
entries | この検索結果の件数 | 整数 | 47 |
total_entries | 検索結果の全件数 | 整数 | 47 |
area | *** | *** | *** |
- id | エリアID | 整数 | 1 |
- name | エリア名 | 文字列 | 銀座、新橋、有楽町 |
<?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_key | APIキー | ロケタッチグルメ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 |
フィールド | 説明 | 型 | 値 |
version | API のバージョン | 文字列 | 1.0 |
current_page | 現在のページ | 整数 | 1 |
entries | この検索結果の件数 | 整数 | 10 |
total_entries | 検索結果の全件数 | 整数 | 10 |
station | *** | *** | *** |
- id | 駅ID | 整数 | 1996 |
- name | 駅名 | 文字列 | 銀座 |
- name_kana | 駅名ひらがな | 文字列 | ぎんざ |
<?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>
http://api.gourmet.livedoor.com/v1.0/category/?api_key=API_KEY
- ページング無し
- カテゴリID未設定時は大ジャンルを返します
クエリー | 項目 | 説明 | 値、例 |
api_key | APIキー | ロケタッチグルメAPI利用登録時に発行されたキーをセットします。(必須) | 40byteの文字列 |
category_id | カテゴリID | ロケタッチグルメで割り当てられているカテゴリIDで検索します。 | 整数 ex)100 |
type | レスポンスタイプ | 検索結果のフォーマットタイプを xml,json から選択します。 json 指定時、callback の併用で jsonp として動作します。 | xml(初期値) json(+callback) ex)type=json&callback=function |
フィールド | 説明 | 型 | 値 |
version | API のバージョン | 文字列 | 1.0 |
current_page | 現在のページ | 整数 | 1 |
entries | この検索結果の件数 | 整数 | 10 |
total_entries | 検索結果の全件数 | 整数 | 10 |
category | *** | *** | *** |
- id | カテゴリID | 整数 | 100 |
- name | カテゴリ名 | 文字列 | 和食 |
- name_kana | カテゴリ名ひらがな | 文字列 | わしょく |
<?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>
タグ