{
  "api_version": "1.0.0",
  "generated_at": "2026-09-30T22:14:00Z",
  "counts": {
    "locality": 1232,
    "neighborhood": 1145,
    "area": 2756
  },
  "endpoints": {
    "places": "/api/v1/places.json",
    "place": "/api/v1/places/<slug>.json (a slug may contain one '/')",
    "meta": "/api/v1/meta.json"
  },
  "licence": {
    "summary": "Facts and figures derived from public Israeli government data; the parts derived from OpenStreetMap are under the ODbL.",
    "openstreetmap": {
      "licence": "Open Database Licence (ODbL) 1.0",
      "url": "https://opendatacommons.org/licenses/odbl/1-0/",
      "attribution": "© OpenStreetMap contributors",
      "share_alike": "Data derived from OpenStreetMap (neighborhood names and boundaries, street names, Green Line) stays under the ODbL: if you publish a database built from it you must attribute OpenStreetMap and offer that database under the same licence. A record with a non-null `osm_attribution` contains such data."
    },
    "govmap": {
      "attribution": "שמות שכונות: המרכז למיפוי ישראל (GovMap), דרך גרסאות לעם",
      "note": "Neighborhood names of records with name_source `govmap` come from the Survey of Israel's GovMap neighborhoods layer, which states that it is for information only (for information only, not a valid authority for any legal procedure). Only the names are used; the boundary of such a neighborhood is a union of CBS statistical areas. A record with a non-null `name_attribution` contains such names."
    },
    "government_data": "The government sources listed in `attributions` are used with credit. Check each source's own terms before redistributing its raw files; this API publishes derived aggregates, not the raw files.",
    "no_warranty": "Provided as is. Figures are aggregates of official data with the known limits stated in each group's `note` and `source`."
  },
  "attributions": [
    {
      "id": "cbs",
      "name_he": "הלשכה המרכזית לסטטיסטיקה (הלמ\"ס)",
      "name_en": "Central Bureau of Statistics (CBS)",
      "used_for": "population, socio-economic clusters, localities file, statistical areas, census 2022, land area, average rents of the large cities (Price Statistics Monthly, Table 4.9)"
    },
    {
      "id": "cec",
      "name_he": "ועדת הבחירות המרכזית",
      "name_en": "Central Elections Committee",
      "used_for": "Knesset 22-25 results by polling station"
    },
    {
      "id": "tax_authority",
      "name_he": "רשות המסים",
      "name_en": "Israel Tax Authority",
      "used_for": "real-estate transactions; the list of tax-benefit localities 2026 (Reshumot, Kovetz HaTakanot 12212)"
    },
    {
      "id": "local_authorities",
      "name_he": "הרשויות המקומיות",
      "name_en": "Local authorities",
      "used_for": "arnona (municipal property tax) rates 2026-2027, from each authority's own tax order"
    },
    {
      "id": "moe",
      "name_he": "משרד החינוך",
      "name_en": "Ministry of Education",
      "used_for": "schools and kindergartens layer, bagrut indicators (shkifut), RAMA achievement data"
    },
    {
      "id": "police",
      "name_he": "משטרת ישראל",
      "name_en": "Israel Police",
      "used_for": "recorded crime cases"
    },
    {
      "id": "interior",
      "name_he": "משרד הפנים",
      "name_en": "Ministry of Interior",
      "used_for": "municipal elections 2024 (Mabat Pnim)"
    },
    {
      "id": "construction",
      "name_he": "משרד הבינוי והשיכון",
      "name_en": "Ministry of Construction and Housing",
      "used_for": "urban renewal complexes, subsidised-housing lotteries"
    },
    {
      "id": "labor",
      "name_he": "משרד העבודה",
      "name_en": "Ministry of Labor",
      "used_for": "day-care centres"
    },
    {
      "id": "data_gov_il",
      "name_he": "data.gov.il",
      "name_en": "data.gov.il (Israel government open data portal)",
      "used_for": "distribution channel of several of the datasets above"
    },
    {
      "id": "over",
      "name_he": "גרסאות לעם (over.org.il)",
      "name_en": "Over HaAm (over.org.il)",
      "used_for": "mirrors of government datasets and layers used as inputs",
      "thanks": "תודה לגיא זומר"
    },
    {
      "id": "osm",
      "name_he": "OpenStreetMap",
      "name_en": "OpenStreetMap",
      "used_for": "neighborhood names, points and boundaries, street names, English names (name:en) of localities and neighborhoods, employment zones (the workplace picker), the Green Line",
      "licence": "ODbL 1.0",
      "attribution": "© OpenStreetMap contributors"
    },
    {
      "id": "govmap",
      "name_he": "המרכז למיפוי ישראל (GovMap)",
      "name_en": "Survey of Israel (GovMap)",
      "used_for": "official neighborhood names (names only; no GovMap geometry is published), through the OVER mirror",
      "licence": "not an open licence; the layer is for information only",
      "attribution": "שמות שכונות: המרכז למיפוי ישראל (GovMap), דרך גרסאות לעם"
    },
    {
      "id": "home_front_command",
      "name_he": "פיקוד העורף",
      "name_en": "Home Front Command",
      "used_for": "time to shelter per alert area (snapshot of the public districts file, 2026-09-30)"
    },
    {
      "id": "natural_earth",
      "name_he": "Natural Earth",
      "name_en": "Natural Earth",
      "used_for": "coast, lakes and international borders for the distances to the sea and to the borders",
      "licence": "public domain"
    },
    {
      "id": "mot",
      "name_he": "משרד התחבורה",
      "name_en": "Ministry of Transport",
      "used_for": "rail and light-rail stations for the distance to the nearest station (GTFS feed of public transport)"
    },
    {
      "id": "che",
      "name_he": "המועצה להשכלה גבוהה",
      "name_en": "Council for Higher Education",
      "used_for": "the official list of recognised institutions, for the distance to the nearest campus"
    },
    {
      "id": "computed",
      "name_he": "חישוב עצמי",
      "name_en": "Computed by this project",
      "used_for": "distances"
    }
  ],
  "fields": {
    "places.json": [
      {
        "name": "slug",
        "type": "string",
        "unit": "kebab-case ASCII; a neighborhood or area is '<locality slug>/<unit>'",
        "description": "Stable URL slug; also the path of the full record under places/."
      },
      {
        "name": "id",
        "type": "integer",
        "unit": null,
        "description": "Numeric id: CBS locality code for a locality, generated id for a neighborhood or area."
      },
      {
        "name": "cbs_locality_code",
        "type": "integer",
        "unit": "CBS locality code",
        "description": "Locality the place belongs to (its own code for a locality)."
      },
      {
        "name": "name_he",
        "type": "string",
        "unit": null,
        "description": "Hebrew name."
      },
      {
        "name": "name_en",
        "type": "string|null",
        "unit": null,
        "description": "CBS official English name of a locality, OpenStreetMap name:en of a neighborhood; null when none is published."
      },
      {
        "name": "kind",
        "type": "string",
        "unit": "locality | neighborhood | area",
        "description": "Kind of place. An area is a CBS 2011 statistical area."
      },
      {
        "name": "locality_slug",
        "type": "string|null",
        "unit": null,
        "description": "Slug of the containing locality; null for a locality."
      },
      {
        "name": "lat",
        "type": "number",
        "unit": "degrees WGS84",
        "description": "Display point latitude."
      },
      {
        "name": "lon",
        "type": "number",
        "unit": "degrees WGS84",
        "description": "Display point longitude."
      },
      {
        "name": "population",
        "type": "integer|null",
        "unit": "residents",
        "description": "CBS population; see pop_as_of."
      },
      {
        "name": "pop_as_of",
        "type": "string|null",
        "unit": "ISO date",
        "description": "Date of the population figure."
      },
      {
        "name": "ses",
        "type": "object|null",
        "unit": "CBS socio-economic cluster 1 (lowest) to 10",
        "description": "{cluster, year, basis} for a locality (official) or an area; {min, max, year, basis} for a neighborhood (range over its areas). null when the CBS gives none."
      },
      {
        "name": "top_party_k25",
        "type": "object|null",
        "unit": "share: fraction 0-1 of valid votes",
        "description": "{letter, name, share}: leading party in Knesset 25 in the place's own polling stations (or nearby ones, see the record's elections.source)."
      },
      {
        "name": "district",
        "type": "string|null",
        "unit": "north | haifa | center | tel_aviv | jerusalem | south | judea_samaria",
        "description": "CBS district (inferred for a few localities, see record)."
      },
      {
        "name": "green_line",
        "type": "string|null",
        "unit": "inside | beyond",
        "description": "Side of the Green Line at the display point."
      },
      {
        "name": "green_line_km",
        "type": "number|null",
        "unit": "km, straight line",
        "description": "Distance from the display point to the Green Line (the 1949 armistice ways), from either side."
      },
      {
        "name": "sea_km",
        "type": "number|null",
        "unit": "km, straight line",
        "description": "Distance from the display point to the nearest of the Mediterranean, the Kinneret and the Red Sea at Eilat. The Dead Sea does not count."
      },
      {
        "name": "sea_name",
        "type": "string|null",
        "unit": "mediterranean | kinneret | red_sea",
        "description": "Which of those is the nearest."
      },
      {
        "name": "border_km",
        "type": "number|null",
        "unit": "km, straight line",
        "description": "Distance from the display point to the nearest border of Israel (Lebanon, Syria, Jordan, Egypt) or the Gaza Strip boundary. Approximate: 1:10m map."
      },
      {
        "name": "border_name",
        "type": "string|null",
        "unit": "lebanon | syria | jordan | egypt | gaza",
        "description": "Which border is the nearest."
      },
      {
        "name": "rail",
        "type": "object|null",
        "unit": "{km, name, mode, feed_date, source}",
        "description": "Nearest rail or light-rail station from the display point, straight line: km, station name (Hebrew), mode (train | light_rail), date of the Ministry of Transport GTFS feed, source. Light rail: Jerusalem and the Tel Aviv Red Line."
      },
      {
        "name": "higher_ed",
        "type": "object|null",
        "unit": "{km, name, type, campus, source}",
        "description": "Nearest campus of an institution recognised by the Council for Higher Education, straight line: km, institution name (Hebrew), type (university | academic_college | education_college), campus, source."
      },
      {
        "name": "tax_benefit",
        "type": "object|null",
        "unit": "{rate_pct, ceiling_nis, points, year, source}",
        "description": "Income-tax credit of the locality (a tax-benefit locality 2026): credit rate in percent, annual income ceiling in NIS, points. null = not a listed locality. A neighborhood or area carries its locality's."
      },
      {
        "name": "arnona",
        "type": "object|null",
        "unit": "{min_ppm_year, max_ppm_year, main_zone_name, main_ppm_year_100m2, status, year, source_url, source_page}",
        "description": "Residential arnona from the authority's own tax order, NIS per m2 per year; `year` is the order's year (2026; 2027 for an order in force from 1.1.2027; 2025 where the authority's 2026 order was not found): lowest and highest rate over zones and building types, and the rate of the main zone for a 100 m2 flat when the order names one (a stepped tariff gives the effective rate per m2). status: approved | pending (the order posted is a request or a draft, so final rates may differ). null = the authority is not among the largest non-regional-council authorities read, or its order could not be read. An area or neighborhood carries its locality's, with level \"locality\"."
      },
      {
        "name": "rent",
        "type": "object|null",
        "unit": "{by_rooms, period, source, source_url, level}",
        "description": "Average monthly rent in NIS of contracts in force (CBS Price Statistics Monthly, Table 4.9), for the national total (`all`) and the room groups 1-2, 2.5-3, 3.5-4 and 4.5+: `by_rooms` maps each to {avg_nis, period} (avg_nis null where the CBS shows a dash); `period` is the quarter, e.g. 2026-Q2. Average of rent contracts in force, not asking rents, so it understates what a new tenant pays. The CBS publishes it only for the large cities (over 100 thousand residents): null = the locality is not in the table. An area or neighborhood carries its locality's, with level \"locality\"; no official neighborhood rent exists."
      },
      {
        "name": "shelter_sec",
        "type": "object|null",
        "unit": "{min, max, as_of, source}",
        "description": "Seconds to reach shelter (Home Front Command alert areas of the locality; min and max when it has several). Not scored. null = no alert area maps to the locality."
      }
    ],
    "place record": [
      {
        "name": "sources",
        "type": "object",
        "unit": null,
        "description": "For every figure group present: {source, source_id (see meta.attributions), year and/or as_of}."
      },
      {
        "name": "ses_summary, ses / ses_official / ses_range",
        "type": "object",
        "unit": "CBS cluster 1-10",
        "description": "ses_summary is the same compact object as `ses` in places.json; ses, ses_official and ses_range are the underlying blocks."
      },
      {
        "name": "population, pop_as_of, pop_2014, pop_2024, growth_10y_pct",
        "type": "number",
        "unit": "residents; percent",
        "description": "CBS population and 10-year change."
      },
      {
        "name": "demographics",
        "type": "object",
        "unit": "percent of Israeli residents",
        "description": "Population groups (CBS 2024) and census-2022 main religion of the areas."
      },
      {
        "name": "elections",
        "type": "object",
        "unit": "shares: fraction 0-1 of valid votes",
        "description": "Per Knesset 22-25: bloc shares (liberal, likud, haredi, religious_zionist, right_other, arab, other), top_party, parties, turnout_in_kalpi (in-station turnout, lower than official), n_kalpis, split indices. parties is [{letter, name, share}] for every party with at least 1% in the place, biggest first, then {letter: null, name: 'אחרות', share} for the rest, so the shares sum to 1 within rounding; it uses the same polling stations and weighting as the bloc shares (see elections.source.kind: own or nearby). The former single bloc `religious` is split into haredi (Shas, United Torah Judaism) and religious_zionist; the reason for each list is in pipeline/mappings/blocs_k*.csv."
      },
      {
        "name": "realestate",
        "type": "object",
        "unit": "NIS; NIS per m2; deals (n)",
        "description": "Median price and price per m2 by rooms and home type, trend, unusual deals excluded."
      },
      {
        "name": "schools",
        "type": "object",
        "unit": "count",
        "description": "Schools by stream."
      },
      {
        "name": "achievements",
        "type": "object",
        "unit": "share 0-1; score",
        "description": "RAMA achievements relative to schools with a similar background."
      },
      {
        "name": "crime",
        "type": "object",
        "unit": "cases per 1,000 residents per year",
        "description": "Recorded police cases by group."
      },
      {
        "name": "education",
        "type": "object",
        "unit": "percent",
        "description": "Bagrut eligibility vs national, kindergartens and day-care nearby."
      },
      {
        "name": "urban_renewal, subsidised_supply",
        "type": "object",
        "unit": "count; units; NIS per m2",
        "description": "Declared urban-renewal complexes; discounted-housing (Dira BeHanacha) lotteries held from 2023-01-01 on (subsidised_supply.window_start); the newest lottery in the source is dated in subsidised_supply.last_lottery."
      },
      {
        "name": "municipal",
        "type": "object",
        "unit": "share 0-1",
        "description": "Mayor and turnout, municipal elections 2024."
      },
      {
        "name": "density",
        "type": "object",
        "unit": "residents per km2; km2",
        "description": "Locality only."
      },
      {
        "name": "distances",
        "type": "object",
        "unit": "km",
        "description": "Great-circle distance to Tel Aviv, Jerusalem and the nearest metropolitan centre."
      },
      {
        "name": "boundaries, osm_attribution",
        "type": "string",
        "unit": null,
        "description": "Where the boundary comes from; osm_attribution is set when OpenStreetMap-derived data is inside the record (ODbL)."
      },
      {
        "name": "name_source, name_attribution, also_includes",
        "type": "string",
        "unit": null,
        "description": "Neighborhood only: how the name was found (govmap, osm_polygon, osm_point, main_street, nearby, stat_area); name_attribution is the credit when the name comes from GovMap; also_includes lists other GovMap neighborhoods covering at least 15% of the unit."
      }
    ]
  },
  "notes": [
    "null means unknown or not published, never zero.",
    "Slugs never change once published; a removed place keeps its slug reserved (mappings/slugs.csv).",
    "Areas are CBS 2011 statistical areas; neighborhoods are groups of areas named from GovMap (name_source govmap), else from OpenStreetMap, or 'near <street>' when approximate.",
    "Election results of areas and neighborhoods for Knesset 22-24 rest on the assumption that the polling-place numbering did not change between elections (the polling places' locations come from the Knesset 26 list, checked against the Knesset 25 list); they are in the records but are not shown on the website.",
    "GovMap neighborhood names: Survey of Israel layer for information only, used for names only; the boundaries stay unions of CBS areas."
  ]
}