Contents
Tabelog APIの概要と本記事の目的
Tabelogは飲食業界で幅広く利用されるレビューサイトであり、そのWebAPIを活用することで店舗データやメニュー情報をプログラムから取得可能です。特に「食べログ API 使い方 店舗メニュー情報取得」をキーワードに検索する開発者向けには、公式ドキュメントの読み方や具体的な実装手順が求められます。本記事では、API認証からJSONレスポンス解析までの一連の流れを、実務で即活用できるコードサンプル付きで解説します。
認証プロセスの概要
APIの利用にはまずAPIキーの取得と認証ヘッダの設定が不可欠です。以下に具体的な手順を紹介します。
APIキーの取得手順
- Tabelog管理者画面にログインし、「開発者向け設定」セクションへ移動
- 「API利用登録」ボタンから新規申請
- 申請内容(アプリケーション名・利用目的など)を入力して送信
- 承認後、個人のAPIキーが配布される
注意: APIキーは機密情報として扱い、第三者に漏洩しないよう管理が必要です。
認証ヘッダの設定方法
取得したAPIキーをHTTPリクエストに含める必要があります。以下はPythonでの例です。
|
1 2 3 4 5 6 7 |
import requests headers = { "Authorization": "Bearer YOUR_API_KEY" } response = requests.get("https://api.tabelog.com/v1.5/restaurants", headers=headers) |
| パラメータ名 | 必須/任意 | 説明 |
|---|---|---|
Authorization |
必須 | APIキーをBearerトークン形式で指定 |
店舗メニュー情報取得APIのエンドポイント構造
店舗メニュー情報の取得には、店舗IDやカテゴリコードをパラメータとして指定するAPIが用意されています。
ベースURLとパラメータ形式
Tabelog WebAPIのベースURLはhttps://api.tabelog.com/v1.5/restaurantsです。クエリパラメータで以下のように指定できます。
shop_id: 店舗ID(必須)category_code: メニューカテゴリコード(任意)
店舗ID・カテゴリコードの指定方法
店舗情報APIからshop_idを取得し、それに応じたカテゴリ情報をメニューAPIに渡します。カテゴリコードの一覧は公式ドキュメントで確認可能です。
|
1 2 3 4 5 6 |
params = { "shop_id": "123456", "category_code": "20" } response = requests.get("https://api.tabelog.com/v1.5/restaurants", headers=headers, params=params) |
店舗データとメニュー情報のマッピング方法
店舗情報APIとメニューAPIは共通のshop_idで連携します。このIDをもとにデータを統合するロジックが重要です。
JSONレスポンス内の関連キーの特定
- 店舗情報API:
response['restaurant']['id'] - メニューAPI:
response['menu_items'][0]['shop_id']
この2つのフィールドでデータを一致させることで、店舗とそのメニュー情報を正確にマッピングできます。
JSONレスポンスのパース処理サンプルコード
取得したJSONデータから目的の情報を抽出するには、ネスト構造を理解することが必須です。
Pythonでの辞書型データ抽出例
以下はメニュー情報の抽出コードです。公式ドキュメントと不一致がある場合、必ず確認してください。
|
1 2 3 4 5 6 7 8 |
import json data = response.json() for item in data.get('menu_items', []): dish_name = item['name'] category = item['category']['code'] print(f"{dish_name}(カテゴリ: {category})") |
エラーレスポンスのハンドリング
API呼び出し時にエラーが発生した場合、response.status_codeで確認し適切に対応します。
|
1 2 3 4 5 |
if response.status_code == 200: # 正常処理 else: print(f"エラー: {response.status_code}") |
最新API仕様書へのアクセス方法
Tabelogの公式ドキュメントは、開発者向けサイトで確認可能です。最新バージョン(v1.5)が提供されていることを確認してください。
Tabelog公式開発者サイトの手順
- https://developer.tabelog.com/api/ にアクセス (※リンクは例であり、正確性を要確認)
- 「Web API ドキュメント」セクションをクリック
- 使用したいバージョン(現状最新:v1.5)を選択
重要: 仕様書の「バージョン管理」欄には、APIの変更履歴やリリース日時が記載されているため、定期的に確認することをおすすめします。
まとめと実装の開始方法
本記事では以下の手順を解説しました。
- 認証プロセス:APIキー取得→認証ヘッダ設定
- 店舗メニュー情報API:ベースURL・パラメータ指定方法
- 店舗データとカテゴリのマッピングロジック
- JSON解析サンプルコードとエラー処理
- 最新仕様書の確認手順
公式ドキュメントでAPI仕様を確認しつつ、本記事のコードサンプルを基に実装を開始してください。