{ "api_version": "1.0.0", "generated_at": "2026-10-04T20:16:22Z", "counts": { "locality": 1232, "neighborhood": 1131, "area": 2877 }, "endpoints": { "places": "/api/v1/places.json", "place": "/api/v1/places/.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" }, { "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, parks, libraries and community centres", "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) and the 27 general hospitals (layer 100, for the distance to the nearest hospital), 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 '/'", "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 the latest election in the data (Knesset 25 in this export; the name keeps k25 so existing readers do not break) 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 to the nearest of the Mediterranean, the Kinneret and the Red Sea at Eilat; the Dead Sea does not count. A neighborhood or area: from its display point. A locality: the median over its residents' inhabited areas (the record also has sea_km_min and sea_km_max, its nearest and farthest area), because a town's centre point says little about a town several kilometres wide." }, { "name": "sea_name", "type": "string|null", "unit": "mediterranean | kinneret | red_sea", "description": "Which of those is the nearest (for a locality, to its median area)." }, { "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, by_mode, feed_date, source}", "description": "Nearest station of either kind, straight line: km, station name (Hebrew), mode (train = Israel Railways | light_rail), date of the Ministry of Transport GTFS feed, source. by_mode is the same for each kind on its own, {train: {km, name}, light_rail: {km, name}}, so a place shows both kinds apart. Light rail in service in the feed: Jerusalem and the Tel Aviv Red Line (with its Petah Tikva and Bat Yam branches). The Haifa Carmelit and cable car are neither kind and are left out. A neighborhood or area: from its display point. A locality: the median over its residents' inhabited areas, with km_min and km_max (nearest and farthest area; the by_mode entries carry them too), inside (the stations within the locality, [{name, mode}]) and basis residents_median." }, { "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. A neighborhood or area: from its display point. A locality: the median over its residents' inhabited areas, with km_min and km_max, inside (the institutions with a campus within the locality, [{name, type}]) and basis residents_median." }, { "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, apt_min_ppm_year, apt_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 (apt_min / apt_max: the same for a regular 100 m2 apartment, without house-only, large-flat and luxury classes), 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's order was not read (not yet collected, blocked, or unreadable). `authority` is city, local_council or regional_council (from the CBS localities file). A locality of a regional council carries the council's block (`council_code`, `council_name`): one council order, whose min and max span the council's zones; local committee (ועד מקומי) taxes are not included. An area or neighborhood carries its locality's, with level \"locality\"." }, { "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": "price_trend", "type": "object|null", "unit": "percent; NIS per m2; deals (n)", "description": "Nominal (not inflation-adjusted) change of the median price per m2 of apartments in multi-storey buildings, existing buildings only, unusual deals excluded: the 12 months ending window_end against the same 12 months 5 and 10 years earlier. horizons.y5 / y10 = {change_pct, ppm_now, ppm_then, n_now, n_then, then_end}, present only when both windows hold at least 10 deals. null = no horizon qualifies." }, { "name": "census_age", "type": "object|null", "unit": "percent of residents; years; persons per household", "description": "Census 2022 (CBS): age_median (a weighted mean of the median ages of the census areas when median_approx is true), age0_19_pct, age65_pct, household_size; level is area (worked out on the unit's own outline by area-weighted overlay of the 2022 statistical areas) or locality (the whole locality's figures, when the unit holds fewer than 100 residents in the overlay). null = the census has no figure." }, { "name": "services", "type": "object|null", "unit": "count; metres", "description": "Libraries and community centres from OpenStreetMap (ODbL): {library, community_centre} each {count inside the unit, nearest {name, m} for an area or neighborhood; m_min, m_median, m_max over the inhabited areas for a locality}. Religious sites are not included. Volunteer-mapped, so completeness varies." }, { "name": "hospital", "type": "object|null", "unit": "km, straight line", "description": "Nearest general hospital (GovMap layer 100, 27 hospitals): {name, locality, km, level, source}. A locality: the median over its residents' inhabited areas with km_min, km_max and inside (names of the hospitals within the locality). No claim is made about the services of a hospital." }, { "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's land, and GovMap neighborhoods with at least 100 address points that no unit carries by name, added to the unit that holds most of those addresses." } ] }, "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 ' 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." ] }