# نمودا (Nemuda)

> نمودا publishes one figure per place in Iran: what a square metre costs there, for five kinds of property.
> قیمت‌هایی که فروشنده‌ها اعلام کرده‌اند — these are the prices sellers are asking, not prices anything sold for.

## What the numbers mean

- The headline is the typical asking price of one square metre, in toman, for one kind of property:
  apartments (the default, at every address with no kind in it), houses and villas (`/house/…`),
  land (`/land/…`), shops (`/shop/…`) and offices (`/office/…`). The kinds are never mixed: per
  metre they are different markets. Land is priced per metre of GROUND, the others per built metre.
- A figure can be narrowed by attributes of the property. Each kind's attributes and options are listed at
  https://api.nemuda.com/api/market/meta (propertyKinds[].facets). A narrowed figure is the same statistic over
  the prices whose seller STATED that attribute; an unstated attribute is never matched, so a narrowed count
  is not a share of the whole. With fewer than ten behind it, no figure is published, and a narrowed count
  under ten is not kept (dataPoints is null). Narrowed figures keep no history.
- Every figure covers the last 14 days, ending 2026-09-25.
- Last computed ۳ مهر ۱۴۰۵، ساعت ۲۱:۴۰ (2026-09-25T18:10:46.908Z). It is recomputed every six hours.
- A place with too few homes for sale publishes no figure at all, rather than a figure about two homes.
- Nothing below a place is ever published: no property, no address, no seller.

## Where the data is

- Every published place, as a page: https://nemuda.com/sitemap.xml (4244 places)
- Pages exist for these narrowed views, at /{kind}/{option}/{province}/{city} (987 pages):
  1-bedroom, 2-bedroom, 3-bedroom-plus, new-build (apartments); land/residential, land/garden, land/farm, land/commercial (land); shop/goodwill (shops). They are in the sitemap.
- Any other narrowed view is drawn in the browser from an address like /tehran-province/tehran#rooms=2&age=new.
  The HTML at that address is the UNFILTERED page. For exact figures use the JSON with the same parameters:
  https://api.nemuda.com/api/market/real-estate/places/{placeId}?rooms=2&age=new
  (another kind adds its name: ?propertyKind=land&use=garden).
- What each single change to a selection would show at one place:
  https://api.nemuda.com/api/market/real-estate/places/{placeId}/facets?rooms=2
- The same content as plain text: append `/index.txt` to any page address, e.g. https://nemuda.com/tehran-province/tehran/index.txt
  Its first line names the page to cite. One line gives `computedAt` (UTC) and the window as ISO 8601.
- JSON, public and unauthenticated:
  - Freshness: https://api.nemuda.com/api/market/meta
  - The country and every province: https://api.nemuda.com/api/market/real-estate/summary
  - Every place and whether it publishes a figure: https://api.nemuda.com/api/market/real-estate/place-index
  - One place: https://api.nemuda.com/api/market/real-estate/places/{placeId}
  - What is inside a place: https://api.nemuda.com/api/market/real-estate/places/{placeId}/children

## What the JSON fields mean

- `pricePerM2` — toman per built square metre. The typical figure, not an average.
- `pricePerM2Range` — `{low, high}` is the MIDDLE HALF: a quarter of homes are cheaper than
  `low` and a quarter dearer than `high`. It is not the cheapest and dearest.
- `priceTotal` — toman for a whole home. `areaM2` — its size in built square metres.
- `pricePerM2`, `priceTotal` and `areaM2` are three SEPARATE typical figures over the same
  homes, not three properties of one home. Multiplying two of them will not give the third,
  and the difference is real rather than a rounding error.
- `coverage` — `solid`, `limited` or `none`. `none` means too few homes to publish a figure,
  and every price field is null. `limited` means the figure rests on a small number of them.
- `placeKind` — `country`, `province`, `city` or `district`. `slug` is the address segment.
- `filters` — the attributes the figures in that response are narrowed by; {} means unfiltered.
- `dataPoints` — how many prices the figure stands on; null only on a narrowed figure with fewer than
  ten behind it.
- A city figure is not the average of its neighbourhoods: about a quarter of homes for sale
  name a city and no neighbourhood, and they count toward the city but toward no neighbourhood.

## Geography

- Four levels: کشور (country) › استان (province) › شهر (city) › محله (neighbourhood).
- A page address is the trail of slugs, e.g. /tehran-province/tehran/zafaraniyeh.
- Province boundaries drawn on the site: © OpenStreetMap contributors.