Data specification

All 1,212 chains and 336,077 stores. Two CSVs per brand (BOM UTF-8 / RFC 4180 / compatible with Excel, BigQuery, pandas, etc.).

1. standard (common 33 columns — cross-chain analysis)

Fixed 33 columns across all chains. Provided in both Excel and CSV. Same column structure for every chain, so you can concatenate multiple chains vertically for cross-chain analysis.

ColumnDescription
ldb_idPermanent store ID (unchanged across re-scrapes, site redesigns, and brand renames. Recommended join key)
brand_idBrand ID (ASCII slug, e.g. starbucks)
place_idStable ID unique within brand — unchanged across re-scrapes
nameStore name
name_kanaName (kana reading)
name_enEnglish store name
addressAddress (from prefecture)
prefecturePrefecture (auto-extracted from address — use directly in GROUP BY)
postal_codePostal code
latitude / longitudeLatitude/longitude (WGS84). Coordinate fill rate is nearly 100%
access_infoAccess info (nearest station, bus stop, IC, etc.)
phonePhone number
store_urlStore detail page URL
business_hoursBusiness hours
closed_daysClosed days
open_24h24-hour operation (TRUE/FALSE)
open_dateOpening date
parkingParking available (TRUE/FALSE)
parking_capacityParking capacity (integer)
drive_throughDrive-through (TRUE/FALSE)
seat_countSeat count
dine_in / takeout / deliveryDine-in, takeout, delivery (TRUE/FALSE)
accepts_credit_cardCredit card accepted (TRUE/FALSE)
accepts_e_moneyE-money accepted (TRUE/FALSE)
accepts_qr_paymentQR payment accepted (TRUE/FALSE)
wifiWi-Fi available (TRUE/FALSE)
barrier_freeBarrier-free (TRUE/FALSE)
serves_alcoholServes alcohol (TRUE/FALSE)
servicesServices & facilities list (AED, multi-copier, Uber Eats, etc.)
notesNotes
first_seenFirst detection date in our database (basis for new store detection)
last_seenLast verified date — the last date this store was confirmed on the official website
updated_atLast content change date — when business hours, address, etc. actually changed (not updated by daily existence checks)

Three date columns are key: last_seen tells you if the store is active, first_seen tells you when it appeared, updated_at tells you if content recently changed. Closed stores are excluded from CSV by default.

2. raw (all fields — single file)

In addition to the common columns from standard, this file includes all brand-specific attributes available from the chain's official website as columns. Brand-specific columns vary by chain. Examples:

Download the sample (all St. Marc Café stores) to see the actual format.

Downloaded filename is "brandID_type_date.csv" (e.g. starbucks_standard_20260612.csv). Contents update daily, so the date in the filename = data date.

3. Update cycle

4. REST API

Contracted brands are also accessible via REST API. Usage-based billing from prepaid credits. Issue API keys and top up on yourdashboardSend via Authorization: Bearer ldb_… header. Authorization: Bearer ldb_…

EndpointDescription
GET /v1/brandsList contracted brands with metadata (store count, last update)
GET /v1/brands/{brand}/placesStore list for a brand (active only, max 1,000 per request; pass the response's next_cursor as ?cursor= for more). ?area=渋谷区 for partial address match
GET /v1/places/{ldb_id}Single store lookup (ldb_id = our permanent store ID)
$ curl "https://api.locationsdb.com/v1/brands/starbucks/places?area=中央区" \
    -H "Authorization: Bearer ldb_****"

{
  "brand_id": "starbucks",
  "total": 42,
  "places": [
    {
      "ldb_id": "15efa89cfeb71ddd",
      "name": "銀座マロニエ通り店",
      "address": "東京都中央区銀座3-7-3",
      "latitude": 35.6717, "longitude": 139.7659,
      "business_hours": "07:00~22:00",
      "wifi": true,
      "services": ["モバイルオーダー"],
      "first_seen": "2026-02-28",
      "last_seen": "2026-07-01"
    }
  ]
}

Evaluating for your team?
Need full data for a specific chain for evaluation, or want to request an uncovered chain (added as soon as next day)? Contact us.