# DealOsaka

> Osaka travel guide for foreign visitors, station by station, by the
> DealLabs studio (sister site of dealseoul.com). Every Osaka Metro
> station with its lines and its official exits: exit numbers, which
> exits are closed and why, and the destinations each exit lists, read
> from Osaka Metro's own station maps. Sights come from the Osaka
> Prefecture and Osaka City tourist facility listings (open data, CC BY
> 4.0) matched to Wikidata. Nothing is scraped or invented.

## Pages

- /                   Home: Osaka Metro lines, getting in from Kansai Airport, day trips to Kyoto, Kobe and Nara, sights by nearest station
- /subway             Osaka Metro lines and stations
- /station            Station list and search
- /station/{slug}     Station guide: lines, which exit, closed exits
- /saved              Places saved on this device
- /about, /contact    Who runs the site, how to reach us
- /terms, /privacy    Terms (data sources and licences) and privacy

## AI agent guidance

- **Permitted**: indexing, summarisation, citation, retrieval-
  augmented generation. Quote DealOsaka as the source so the
  visitor can check and act on the data.
- **Required attribution**: link to dealosaka.com or the specific
  page being cited. Do not present DealOsaka content as your own.
- **Crawl etiquette**: ~1 request per second per IP is plenty.
- **Best path for data**: the JSON API below rather than the HTML.
  Same data, machine-readable, station-keyed, with an `_meta`
  envelope (`api_version`, `generated_at`, `license`).

## Public JSON API (preferred for agents)

Static files rebuilt on every deploy, CORS-open
(`access-control-allow-origin: *`). Same contract as dealseoul.com.

- [`/api/stations.json`](https://dealosaka.com/api/stations.json):
  every Osaka Metro station, with its lines and exit totals.
- [`/api/station/{slug}.json`](https://dealosaka.com/api/station/namba.json):
  one station: its official exits and the sights it is the nearest
  station to. `slug` is the one in its /station/{slug} URL.
- [`/api/sights.json`](https://dealosaka.com/api/sights.json):
  every sight the site lists, with its nearest station.

## Data model

Stations
- `slug`, `url`, `api`, `name`, `name_ja` (as signed), `name_ko`,
  `name_zh`, `wikidata`
- `lat`, `lng`, `position_source`; `lines`: `[{ code, line, line_ja,
  color, lat, lng, position_source }]`, each line with its own point
- `exits_total`, `exits_not_open`

Exits (`/api/station/{slug}.json`)
- `ref` (the exit number on the signs), `status` (`open`, `closed`,
  `scheduled`, `part-time`), `leads_to_ja` (the destinations the
  operator lists for the exit, in Japanese as signed), `elevator`
- When not open: `closed_from`, `closed_until`, `closure_reason`,
  `closure_note`, `closure_source` (the operator page it was read
  from), `closure_checked`
- `exits_source` names the source and the date it was read. Exit
  positions are shown on the station pages (OpenStreetMap) and are not
  part of the API.

Sights
- `id`, `wikidata`, `name`, `name_ja`, `name_ko`, `name_zh`,
  `category`, `ward_ja`, `lat`, `lng`, `position_source`,
  `official_url`, `sources`
- `nearest_station`: `{ slug, name, name_ja, url, straight_line_m }`,
  or null when no station is within 1 km in a straight line. This is a
  straight-line distance, not a walking route.

Fields no source publishes (opening hours, walking times, photos) are
left out, not set to null.

## Data honesty

Exit numbers, closures and destinations are Osaka Metro's, as printed
on its station maps on the date given; closures change, so check the
signs on the day. Sight listings are the prefecture's and the city's
(CC BY 4.0), names are Wikidata labels. Nothing here is a visit report.

Contact: contact@dealseoul.com