Skip to content

Address data enrichment

Adds the county, district (járás), settlement code and postal code to an address — where the source contains them. In a uniform structure, the same way on every endpoint.

Example

example

szged

Szeged

CountyCsongrád-Csanád
District (járás)Szegedi
Postal code6710 ... 6791
KSH code33367
GeoNames ID715429
Time zoneEurope/Budapest
Coordinates46.253, 20.14824

The live demo returns the same — the fields above are the actual fields of the API response.

What it does

KSH settlement code

The settlement’s code in the official Gazetteer (Helységnévtár). With it, two databases can be linked even when the spelling of names differs.

County and district (járás)

Administrative classification for the address, as it stands in the Gazetteer.

Postal code

The postal code linked to the address or settlement. If the postal code entered differs from the postal code of the address found, the response flags this separately.

How to call it

A simple REST API with JSON responses. A uniform address object on every endpoint.

The details of the call — parameters, fields, error codes and examples — are in the API documentation. You can also view the raw response in the live demo with the “API response (JSON)” button.

GET /suggest?q=szeged

→ admin{ county, district, settlement_ksh,
    geoname_id }, geo{ timezone }