Developers

Free API and embeddable widgets for Tokyo neighborhood crime data.

REST API

Free, read-only JSON API. No authentication required. All responses include CORS headers.

GET/api/v1/wards

List all 49 wards/cities with 2024 crime summaries.

Example Response

{
  "data": [
    {
      "slug": "adachi",
      "name_en": "Adachi",
      "name_ja": "足立区",
      "type": "ward",
      "total_crimes_2024": 4521,
      "neighborhood_count": 259,
      "avg_crime_rate_per_1000": 6.8
    }
  ],
  "meta": {
    "count": 49,
    "year": 2024,
    "source": "Tokyo Metropolitan Police Department",
    "license": "CC BY 4.0"
  }
}

GET/api/v1/wards/{slug}

Ward detail with all neighborhoods and crime data. Example: /api/v1/wards/shibuya

Example Response

{
  "data": {
    "slug": "shibuya",
    "name_en": "Shibuya",
    "name_ja": "渋谷区",
    "crime_rank": 18,
    "crime_rank_total": 23,
    "total_crimes_2024": 3892,
    "neighborhoods": [
      {
        "slug": "uehara-1",
        "name_en": "Uehara 1-chome",
        "total_crimes": 5,
        "population": 2841,
        "crime_rate_per_1000": 1.8
      }
    ]
  }
}

GET/api/v1/neighborhoods/{ward}/{neighborhood}

Full neighborhood detail: 7-year crime history, breakdown, safety grade, nearest stations. Example: /api/v1/neighborhoods/shibuya/jingumae-1

GET/api/v1/rankings/safest

Top 50 safest neighborhoods in Tokyo (2024).

GET/api/v1/crime/trends

City-wide crime trends (2018-2024) with category breakdowns.

Usage Notes

All endpoints are cached (24h). Responses are fast and free.
No API key required. No rate limit currently enforced.
Please include attribution to japanneighborhoods.com when using data.
For bulk downloads, consider using our CSV datasets on Kaggle.

Embeddable Safety Badge

Add a neighborhood safety badge to your website. Each badge shows the safety grade, crime rate, and links back to the full neighborhood profile.

Preview

How to Embed

Copy this code and replace the ward/neighborhood slugs:

<iframe
  src="https://japanneighborhoods.com/embed/safety/{ward}/{neighborhood}"
  width="340" height="80"
  style="border:none;border-radius:8px"
  title="Neighborhood Safety Score">
</iframe>

Available Wards

Find neighborhood slugs on each ward page, or use the /api/v1/wards/{slug} endpoint.

License & Attribution

License: All data is available under CC BY 4.0 (Creative Commons Attribution).

Required attribution: When using our data or API, please include:

Data from Japan Neighborhoods (japanneighborhoods.com), sourced from Tokyo Metropolitan Police Department.

Original source: Tokyo Metropolitan Police Department (警視庁), published under CC BY 4.0 by Tokyo Metropolitan Government Open Data Catalog.