グルメサーチAPI / ホットペッパー / web api

グルメサーチAPI

登録されているお店の一覧を取得します。

api URL

api url: http://webservice.recruit.co.jp/hotpepper/gourmet/v1/
format: json / jsonp / xml
method: GET
認証: ApiKey
実行制限: なし
公式ドキュメント: http://webservice.recruit.co.jp/hotpepper/reference.html#a1to

parameter set

parameter	value	省略	説明
key	MyApiKey-key をセット	必須	APIキー。アカウント登録時に取得したキー。 [MyApiKey-key]を指定すると、Apiキーを預けるで設定されたApiキーに自動変換します。
id		可	お店ID。カンマ区切りで20個まで複数指定可能。
name		可	掲載店名。（部分一致）
name_kana		可	掲載店名かな検索。（部分一致）
name_any		可	掲載店名または掲載店名かな。部分一致。「掲載店名」または「掲載店名かな」を対象に部分一致検索。
tel		可	お店の電話番号。ハイフン無し。
address		可	お店の住所。部分一致。
special		可	特集コード。カンマ区切りで複数指定可能。AND検索。
special_or		可	特集コード。カンマ区切りで複数指定可能。OR検索。
special_category		可	特集カテゴリコード。カンマ区切りで複数指定可能。AND検索。
special_category_or		可	特集カテゴリコード。カンマ区切りで複数指定可能。OR検索。
is_open_time		可	営業時間。 now : 現在時刻で営業中。 hh:mm : 指定時刻で営業中。
is_open_week		可	営業曜日。is_open_timeと組み合わせて使う。カンマ区切りで複数指定可能。 1:月曜 2:火曜 3:水曜 4:木曜 5:金曜 6:土曜 7:日曜 8:祝前日 9:祝日
large_service_area		可	大サービスエリアコード。
service_area		可	サービスエリアコード。カンマ区切りで3個まで指定可能。
large_area		可	大エリアコード。カンマ区切りで3個まで指定可能。
middle_area		可	中エリアコード。カンマ区切りで5個まで指定可能。
small_area		可	小エリアコード。カンマ区切りで5個まで指定可能。
keyword		可	店名かな、店名、住所、駅名、お店ジャンルキャッチ、キャッチのフリーワード検索。部分一致。半角スペース区切りでAND検索。
lat		可	緯度。
lng		可	経度。
range		可	緯度経度からの検索範囲。省略時は1000m。
datum		可	測地系。省略時は世界測地系。
ktai_coupon		可	携帯クーポンの有無。省略時は絞込みしない。
genre		可	お店ジャンルコード。カンマ区切りで複数指定可能。
food		可	料理コード。カンマ区切りで5個まで指定可能。
budget		可	検索用予算コード。カンマ区切りで2個まで指定可能。
party_capacity		可	宴会収容人数。指定数より大きな収容人数のお店を検索。
wifi		可	WiFi経由でインターネット利用が可能か絞り込む。省略時は絞り込まない。
wedding		可	ウェディング・二次会等が可能か絞り込む。省略時は絞り込まない。
course		可	「コースあり」の条件で絞り込む。省略時は絞り込まない。
free_drink		可	「飲み放題」の条件で絞り込む。省略時は絞り込まない。
free_food		可	「食べ放題」の条件で絞り込む。省略時は絞り込まない。
private_room		可	「個室あり」の条件で絞り込む。省略時は絞り込まない。
horigotatsu		可	「掘りごたつあり」の条件で絞り込む。省略時は絞り込まない。
tatami		可	「座敷あり」の条件で絞り込む。省略時は絞り込まない。
cocktail		可	「カクテル充実」の条件で絞り込む。省略時は絞り込まない。
shochu		可	「焼酎充実」の条件で絞り込む。省略時は絞り込まない。
sake		可	「日本酒充実」の条件で絞り込む。省略時は絞り込まない。
wine		可	「ワイン充実」の条件で絞り込む。省略時は絞り込まない。
card		可	「カード可」の条件で絞り込む。省略時は絞り込まない。
non_smoking		可	「禁煙席」の条件で絞り込む。省略時は絞り込まない。
charter		可	「貸切可」の条件で絞り込む。省略時は絞り込まない。
ktai		可	「携帯電話OK」の条件で絞り込む。省略時は絞り込まない。
parking		可	「駐車場あり」の条件で絞り込む。省略時は絞り込まない。
barrier_free		可	「バリアフリー」の条件で絞り込む。省略時は絞り込まない。
sommelier		可	「ソムリエがいる」の条件で絞り込む。省略時は絞り込まない。
night_view		可	「夜景がキレイ」の条件で絞り込む。省略時は絞り込まない。
open_air		可	「オープンエア」の条件で絞り込む。省略時は絞り込まない。
show		可	「ライブ・ショーあり」の条件で絞り込む。省略時は絞り込まない。
equipment		可	「エンタメ設備」の条件で絞り込む。省略時は絞り込まない。
karaoke		可	「カラオケあり」の条件で絞り込む。省略時は絞り込まない。
band		可	「バンド演奏可」の条件で絞り込む。省略時は絞り込まない。
tv		可	「TV・プロジェクター」の条件で絞り込む。省略時は絞り込まない。
lunch		可	「ランチあり」の条件で絞り込む。省略時は絞り込まない。
midnight		可	「23時以降も営業」の条件で絞り込む。省略時は絞り込まない。
midnight_meal		可	「23時以降食事OK」の条件で絞り込む。省略時は絞り込まない。
english		可	「英語メニューあり」の条件で絞り込む。省略時は絞り込まない。
pet		可	「ペット可」の条件で絞り込む。省略時は絞り込まない。
child		可	「お子様連れOK」の条件で絞り込む。省略時は絞り込まない。
credit_card		可	クレジットカードコード。カンマ区切りで複数指定可。
type		可	レスポンスタイプ。省略時は、クレジットカード・特集以外をすべて。「lite」を指定すると主要項目のみ。細かい指定方法はドキュメント参照。
order		可	並び順。省略時はオススメ順。
start		可	レスポンスの開始位置。省略時は1。
count		可	1ページあたりの取得件数。1～100の範囲。省略時は10。
format		可	出力形式。

[call update]ボタンを押してください。ここに結果が表示されます。

javascriptでは桁数の大きな数値で値がズレることがあります。
例えば、twitterの id_str と id です。
id_str は文字列型ですので正しい値が表示されます。
id は数値型です。桁数が大きな場合、 +-1のズレが発生することがあります。
id_str と id が異なる場合は、id_str を信用してください。
試しに下記をクリックして実行してみてください。期待する値がalertされるでしょうか？
javascript:eval('var a = 13782936788668417, b = \'13782936788668417\';'); alert(a+' : 数値型'+'\n\n'+b+' : 文字列型');
本サイトでは、javascriptで処理をしている関係上、apiから取得してきたデータと異なることがあります。
あらかじめご理解・ご了承ください。

hotpepper/api/gourmet/v1

グルメサーチAPI

api URL

parameter set

call results

発行したAPIのURLとパラメータ

下記のURLで、本ページの各パラメータに自動的にセットされます。

ホットペッパーAPI

ホットペッパー

ホットペッパーAPI