# CodPostal.info

> Romanian postal code directory. Static site covering every locality and
> street in Romania, generated from the official Poșta Română dataset
> (infocod, May 2016). Content is in Romanian.

Every URL below was verified against the live site. Paths always end in
`.html`; there are no directory-style URLs and no trailing-slash redirects.
Diacritics are stripped from paths (ă→a, ș→s, ț→t) and the result is
lowercased. Some locality paths contain literal spaces, which must be
percent-encoded as `%20` when requesting them.

## Entry points

- [Homepage](https://codpostal.info/): index of the 91 largest cities and all 41 counties
- [Sitemap index](https://codpostal.info/sitemap_index.xml): points to 208 sitemaps covering ~103,000 URLs
- [robots.txt](https://codpostal.info/robots.txt)

## URL patterns

The site has three branches, each with its own URL shape.

### București

- Index of street letters: `/bucuresti.html`
- Streets starting with a letter: `/bucuresti/bucuresti_{letter}.html`
  — e.g. [/bucuresti/bucuresti_m.html](https://codpostal.info/bucuresti/bucuresti_m.html)
- A single street: `/bucuresti/bucuresti_{street}.html`
  — e.g. [/bucuresti/bucuresti_metalurgiei.html](https://codpostal.info/bucuresti/bucuresti_metalurgiei.html)

Street pages list one row per house-number range, each with its own postal
code, sector and post office — a long street has several codes. Rows carry
`id="nr-{from}-{to}"` anchors (`t` means "to the end"), so
`/bucuresti/bucuresti_metalurgiei.html#nr-80-236` links straight to a range.
The fragment `#nr-{number}` also resolves to whichever range contains that
house number.

Note that Romanian streets are numbered by parity: `nr. 1-45` covers odd
numbers on one side, `nr. 2-44` even numbers on the other. A range only
applies to house numbers of the same parity as its first number.

### Cities over 50,000 inhabitants

91 cities, each at the site root.

- City index: `/{city}.html` — e.g. [/cluj-napoca.html](https://codpostal.info/cluj-napoca.html)
- Streets by letter: `/{city}/{city}_{letter}.html` — e.g. [/cluj-napoca/cluj-napoca_m.html](https://codpostal.info/cluj-napoca/cluj-napoca_m.html)
- A single street: `/{city}/{city}_{street}.html`

### Counties and smaller localities

41 counties covering every town, commune and village under 50,000 inhabitants.

- County index: `/judet_{county}.html` — e.g. [/judet_alba.html](https://codpostal.info/judet_alba.html)
- A locality: `/{county}/{locality}.html` — e.g. [/alba/albac.html](https://codpostal.info/alba/albac.html)
- A street inside a locality: `/{county}/{street}_{locality}.html`
  — e.g. `/alba/1%20decembrie%201918_abrud.html`

Most small localities have a single postal code for the whole place, shown on
the locality page. Street pages exist only where the dataset lists named
streets, and they carry the same code as their parent locality; they
canonicalise to the locality page when the street shares its name.

## What a page contains

- The postal code, in a `<span class="postal-code">` element
- The locality and county, or the sector and post office for București
- For street pages, the house-number ranges each code applies to
- An embedded map of the location

Postal codes are six digits, always zero-padded (`010001`, not `10001`).

## Deliberately not provided

- There is no JSON or REST API. The autocomplete endpoint at `/search` is not
  a documented interface and its shape may change without notice.
- There are no pages per sector (`/bucuresti/sector-3.html` does not exist);
  sector information appears on individual street pages instead.
- There is no reverse lookup from a postal code to an address.