全139チェーン・231,653店舗。各ブランドにつき2つのCSVを提供します（BOM付きUTF-8 / RFC 4180 / Excel・BigQuery・pandas等でそのまま読めます）。
全チェーンで共通の21列固定。CSVとExcel（xlsx）の両形式で提供します（xlsxは都道府県コード「01」等の先頭ゼロが崩れません）。どのチェーンも同じ列構成なので、複数チェーンを縦に連結してそのまま横断分析できます。チェーン横断の分析・地図プロット・ジオコーディング不要の位置分析にそのまま使えます。
| 列名 | 説明 |
|---|---|
| ldb_id | 当社採番の永久店舗ID（再取得・サイト改修・チェーン名変更でも不変。結合キーはこれを推奨） |
| chain_id | チェーンID（ASCIIスラッグ。例: starbucks） |
| chain_name | チェーン名 |
| genre | ジャンル（カフェ・コンビニ等。複数は「・」区切り） |
| store_id | ブランド内で一意・再取得しても不変の安定ID |
| name | 店舗名 |
| address | 住所（都道府県から） |
| prefecture | 都道府県（住所から抽出済み — GROUP BYにそのまま使えます） |
| prefecture_code | 都道府県コード（JIS X 0401、01〜47。政府統計・人口データとそのまま結合可） |
| postal_code | 郵便番号（取得できる場合） |
| lat / lng | 緯度・経度（WGS84）。座標充填率はブランドにより95〜100% |
| tel | 電話番号 |
| hours | 営業時間（表記統一済み。24時間営業は「24時間」、単純な時間帯は「10:00-21:00」形式に正規化。元の表記はfull.csvのhours_raw列） |
| holiday | 定休日（「年中無休/なし/無し」等の同義語は「無休」に統一。元の表記はfull.csvのholiday_raw列） |
| url | 店舗詳細ページURL |
| parking | 駐車場（「あり/なし/空欄(不明)」の3値に正規化。元の表記はfull.csvのparking_raw列） |
| parking_capacity | 駐車台数（整数。駐車場チェーンは収容台数。判定できる場合のみ） |
| first_seen | 当社データベースでの初回確認日（出店検知の基準） |
| scraped_at | 最終存在確認日 — この店が公式サイトに掲載されていることを最後に確認した日 |
| updated_at | 内容の最終変更日 — 営業時間・住所等が実際に変わった日（毎日の存在確認では動きません） |
3つの日付列がポイントです。scraped_atで「現役の店か」、first_seenで「いつから存在するか」、updated_atで「最近内容が変わったか」が分かります。閉店した店舗はデフォルトでCSVから除外されます。
standardの21列に加えて、そのチェーンの公式サイトから取得できる固有属性を全部列化したCSVです。住所・座標・鮮度列も 入っているので、このファイルだけで完結します。固有属性の列構成はチェーンごとに異なります。例：
実物はサンプル（サンマルクカフェ全店）をダウンロードして確認してください。
ダウンロードされるファイル名は「チェーンID_種別_日付.csv」（例: starbucks_standard_20260612.csv）。中身は毎日更新されるため、ファイル名の日付＝データの日付です。
契約中のブランドにはREST APIでもアクセスできます。料金は前払いクレジットからの従量課金です。 APIキーの発行とチャージはマイページで発行し、Authorization: Bearer ldb_… ヘッダーで送ります。
| エンドポイント | 説明 |
|---|---|
| GET /api/v1/brands | 契約中ブランドの一覧とメタ情報（店舗数・最終更新日） |
| GET /api/v1/brands/{brand}/stores | ブランドの店舗一覧（営業中のみ・1回最大1,000件、?offset=で続き）。?area=渋谷区 で住所の部分一致絞り込み |
| GET /api/v1/stores/{ldb_id} | 単店舗の取得（ldb_id = 当社採番の永久店舗ID） |
$ curl "https://locationsdb.com/api/v1/brands/saint-marc-cafe/stores?area=中央区" \
-H "Authorization: Bearer ldb_****"
{
"chain_id": "saint-marc-cafe",
"total": 27,
"stores": [
{
"ldb_id": "15efa89cfeb71ddd",
"name": "サンマルクカフェ 大阪北浜店",
"address": "大阪府大阪市中央区…",
"lat": 34.6909, "lng": 135.5063,
"hours": "7:00～21:00",
"details": { "seats": "84席", "wifi": true },
"first_seen": "2026-02-28",
"scraped_at": "2026-06-12"
}
]
}