livedoor グルメ　開発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
  • 検索パラメータ

http://api.gourmet.livedoor.com/v1.0/restaurant/?api_key=API_KEY

• 1ページ10件固定

<?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件固定

<?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>本日２０食限定ばらちらしのランチに伺いました。
１２時ちょい前入店時はノーゲスト状態。
ランチはばらちらしのみの営業なので、そんなに待つことなく出てきます。...</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件まで
• ページング無し

<?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を返します

<?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>

http://api.gourmet.livedoor.com/v1.0/area/?api_key=API_KEY

• ページング無し

<?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>

http://api.gourmet.livedoor.com/v1.0/station/?api_key=API_KEY

• ページング無し

<?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未設定時は大ジャンルを返します

<?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>